Objekt · SldWorks
EnumSketchPoints-Objekt
Eine Aufzählung von Skizzenpunkten (SketchPoint) einer Skizze oder eines Splines, die du mit Next Punkt für Punkt durchgehst. Holen kannst du sie nur mit einer Variante für C++.
Beschreibung
EnumSketchPoints gibt Zugriff auf eine Aufzählung von Skizzenpunkten (SketchPoint). Eine Aufzählung gibt dir die Elemente nicht als Array, sondern eins nach dem anderen. Die Befehle gibt es seit SOLIDWORKS 99.
EnumSketchPoints ist nur für In-Process-DLLs gedacht. In VBA-Makros nimmst du meist besser Sketch.GetSketchPoints2 oder SketchSpline.GetPoints2, das gleich ein Array liefert.
Alle Skizzenpunkte holen: Du rufst EnumSketchPoints.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 EnumSketchPoints.Reset fängst du wieder von vorn an.
Zugriff
- Sketch.IEnumSketchPoints: die Punkte einer Skizze, die Variante für C++
- SketchSpline.IEnumPoints: die Punkte eines Splines, nicht für VBA
EnumSketchPoints.Clone: eine Kopie der Aufzählung
Die Hilfe zeigt für Sketch.IEnumSketchPoints zwar eine VBA-Syntax, ob der Befehl in VBA geht, sagt sie aber nicht. Bei SketchSpline.IEnumPoints schreibt die Hilfe ausdrücklich, dass VBA den Befehl nicht unterstützt. In VBA holst du die Punkte mit Sketch.GetSketchPoints2 oder SketchSpline.GetPoints2 als Array.
Beispiel
' swEnum ist eine Aufzählung der Skizzenpunkte (EnumSketchPoints), etwa aus Sketch.IEnumSketchPoints (C++).
Dim swPunkt As SldWorks.SketchPoint
Dim nGeholt As Long, n As Long
Do
Set swPunkt = Nothing
swEnum.Next 1, swPunkt, nGeholt
If swPunkt Is Nothing Then Exit Do
n = n + 1
Debug.Print n & ": " & swPunkt.X & ", " & swPunkt.Y
LoopBemerkungen
Next in VBA: Next gibt in Rgelt ein Array mit Celt Elementen zurück. Die VBA-Syntax deklariert Rgelt aber als einzelnes SketchPoint, deshalb holst du vermutlich immer genau 1 Element. PceltFetched ist kleiner als Celt, wenn weniger Skizzenpunkte ü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++)“ wählt mit EnumSketchSegments alle Skizzenelemente aus. Für die Skizzenpunkte geht das fast genauso, mit EnumSketchPoints statt EnumSketchSegments.
Sketch.IEnumSketchPoints 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 Skizzenpunkte. |
| Next | Holt den nächsten Skizzenpunkt aus der Aufzählung. |
| Reset | Setzt die Aufzählung an den Anfang zurück, sodass Next wieder den ersten Skizzenpunkt liefert. |
| Skip | Überspringt die angegebene Zahl von Skizzenpunkten in der Aufzählung. |
Siehe auch
Englisches Original: IEnumSketchPoints in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.