Objekt · SldWorks
EnumSketchSegments-Objekt
Eine Aufzählung von Skizzenelementen (SketchSegment) einer Skizze, die du mit Next Element für Element durchgehst. Holen kannst du sie nur mit Varianten für C++.
Beschreibung
EnumSketchSegments gibt Zugriff auf eine Aufzählung von Skizzenelementen (SketchSegment): Linien, Bögen, Splines, Parabeln und Ellipsen. Eine Aufzählung gibt dir die Elemente nicht als Array, sondern eins nach dem anderen. Die Befehle gibt es seit SOLIDWORKS 99.
EnumSketchSegments ist nur für In-Process-DLLs gedacht. In VBA-Makros nimmst du meist besser Sketch.GetSketchSegments oder Sketch.GetSketchTextSegments, das gleich ein Array liefert.
Alle Skizzenelemente holen: Du rufst EnumSketchSegments.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 EnumSketchSegments.Reset fängst du wieder von vorn an.
Zugriff
- Sketch.IEnumSketchSegments: die Elemente einer Skizze, die Variante für C++
- Sketch.IEnumSketchTextSegments: die Elemente des ausgewählten Texts einer Skizze, die Variante für C++
- ModelDoc2.ICreateClippedSplines und ModelDoc2.ICreateSplinesByEqnParams: neu erzeugte Splines, Varianten für C++; ICreateSplinesByEqnParams ist veraltet
EnumSketchSegments.Clone: eine Kopie der Aufzählung
Die Hilfe zeigt für Sketch.IEnumSketchSegments zwar eine VBA-Syntax, ob der Befehl in VBA geht, sagt sie aber nicht. In VBA holst du die Elemente mit Sketch.GetSketchSegments oder Sketch.GetSketchTextSegments als Array.
Beispiel
' swEnum ist eine Aufzählung der Skizzenelemente (EnumSketchSegments), etwa aus Sketch.IEnumSketchSegments (C++).
Dim swSeg As SldWorks.SketchSegment
Dim nGeholt As Long, n As Long
Do
Set swSeg = Nothing
swEnum.Next 1, swSeg, nGeholt
If swSeg Is Nothing Then Exit Do
n = n + 1
Debug.Print n & ": " & "Typ " & swSeg.GetType
LoopBemerkungen
Next in VBA: Next gibt in Rgelt ein Array mit Celt Elementen zurück. Die VBA-Syntax deklariert Rgelt aber als einzelnes SketchSegment, deshalb holst du vermutlich immer genau 1 Element. PceltFetched ist kleiner als Celt, wenn weniger Skizzenelemente ü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.
Hilfebeispiel: „Select All Sketch Segments (C++)“ holt die Aufzählung der aktiven Skizze, geht sie mit EnumSketchSegments.Next durch und wählt jedes Element aus. Es hört auf, sobald Next nicht mehr S_OK zurückgibt.
Typ: SketchSegment.GetType liefert einen Wert aus swSketchSegments_e.
Sketch.IEnumSketchSegments lässt sich auch aus VBA aufrufen und liefert dort eine Aufzählung, die du mit Next durchgehen kannst.
Eigenschaften und Methoden
Methoden 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| Clone | Erstellt eine Kopie der Aufzählung der Skizzenelemente. |
| Next | Holt das nächste Skizzenelement aus der Aufzählung. |
| Reset | Setzt die Aufzählung an den Anfang zurück, sodass Next wieder das erste Skizzenelement liefert. |
| Skip | Überspringt die angegebene Zahl von Skizzenelementen in der Aufzählung. |
Siehe auch
Englisches Original: IEnumSketchSegments in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.