SolidWorksMakroprogrammierung

Objekt · SldWorks

EnumDrSections-Objekt

Eine Aufzählung der Schnittlinien (DrSection) einer Zeichenansicht, die du mit Next Schnittlinie für Schnittlinie durchgehst.

Deklaration Dim x As SldWorks.EnumDrSections · in der englischen .NET-Hilfe: IEnumDrSections

Beschreibung

EnumDrSections gibt Zugriff auf eine Aufzählung von Schnittansichten (DrSection). Gemeint sind die Schnittlinien in einer Zeichenansicht, wie sie View.EnumSectionLines2 liefert. Eine Aufzählung gibt dir die Elemente nicht als Array, sondern eins nach dem anderen. Clone gibt es seit SOLIDWORKS 2000, bei den übrigen Befehlen fehlt die Angabe.

EnumDrSections ist nur für In-Process-DLLs gedacht. In VBA-Makros nimmst du meist besser View.GetSectionLines, das gleich ein Array liefert.

Alle Schnittlinien holen: Du rufst EnumDrSections.Next in einer Schleife mit 1 auf. Vor jedem Aufruf setzt du die Variable für das Element auf Nothing. Ist sie danach noch Nothing, ist die Aufzählung zu Ende. Mit EnumDrSections.Reset fängst du wieder von vorn an.

Zugriff

Die Hilfe nennt noch View.EnumSectionLines, das veraltet ist und durch View.EnumSectionLines2 ersetzt wurde.

Beispiel

' Gibt die nicht unterdrückten Schnittlinien der aktiven Zeichenansicht aus.
' Vorbedingung: Eine Zeichnung ist offen, die Ansicht mit den Schnittlinien ist aktiv.
' Ergebnis:     Name und Beschriftung jeder Schnittlinie stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDraw As SldWorks.DrawingDoc
    Dim swView As SldWorks.View
    Dim swEnum As SldWorks.EnumDrSections
    Dim swSchnitt As SldWorks.DrSection
    Dim nGeholt As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocDRAWING Then Exit Sub
    Set swDraw = swModel
    Set swView = swDraw.ActiveDrawingView
    If swView Is Nothing Then Exit Sub
    Set swEnum = swView.EnumSectionLines2(True)
    If swEnum Is Nothing Then Exit Sub

    Do
        Set swSchnitt = Nothing
        swEnum.Next 1, swSchnitt, nGeholt
        If swSchnitt Is Nothing Then Exit Do
        Debug.Print "Schnittlinie " & swSchnitt.GetName & ", Beschriftung " & swSchnitt.GetLabel
    Loop
End Sub

Bemerkungen

Next in VBA: Next gibt in Rgelt ein Array mit Celt Elementen zurück. Die VBA-Syntax deklariert Rgelt aber als einzelnes DrSection, deshalb holst du vermutlich immer genau 1 Element. PceltFetched ist kleiner als Celt, wenn weniger Schnittlinien übrig sind, oder NULL, wenn keine mehr da sind. Welchen Wert die Variable dann in VBA hat, sagt die Hilfe nicht. Die Schleife prüft deshalb das Element selbst.

Rückgabe: In VBA sind alle vier Befehle Funktionen mit einem HResult. Was der Wert bedeutet, sagt die Hilfe nicht. Du rufst sie ohne Klammern auf und lässt den Wert weg.

Auch ausgeblendete Ansichten: Bei View.EnumSectionLines2 kommen die Schnittlinien auch dann, wenn die Ansicht ausgeblendet ist.

Eigenschaften und Methoden

Methoden 4, davon 4 beschrieben

NameBeschreibung
CloneErstellt eine Kopie der Aufzählung der Schnittlinien.
NextHolt die nächste Schnittlinie aus der Aufzählung.
ResetSetzt die Aufzählung an den Anfang zurück, sodass Next wieder die erste Schnittlinie liefert.
SkipÜberspringt die angegebene Zahl von Schnittlinien in der Aufzählung.

Siehe auch

Englisches Original: IEnumDrSections in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.