Objekt · SldWorks
SketchSegment-Objekt
Steht für ein Element einer Skizze: Linie, Bogen oder Kreis, Ellipse, Parabel oder Spline.
Beschreibung
Jedes gezeichnete Element einer Skizze ist ein SketchSegment. Das Objekt liefert, was alle Elemente gemeinsam haben: die Art, die Länge, ob es eine Konstruktionslinie ist, und es kann sich selbst auswählen.
Für das, was nur eine bestimmte Art hat, etwa den Radius eines Bogens, gibt es eigene Objekte wie SketchLine oder SketchArc. Welche Art ein Element ist, sagt SketchSegment.GetType. Danach weist du es einer Variable des passenden Typs zu.
Zugriff
Sketch.GetSketchSegments: alle Elemente einer SkizzeSketchManager.CreateLine,SketchManager.CreateCircleByRadiusund andere Zeichenbefehle: das neue ElementSelectionMgr.GetSelectedObject6: ein ausgewähltes Element, TypswSelSKETCHSEGS
Beispiel
' Zeigt Art und Länge jedes ausgewählten Skizzenelements.
' Vorbedingung: In einer offenen Skizze sind ein oder mehrere Elemente angeklickt.
' Ergebnis: Liste im Direktfenster (Strg+G im VBA-Editor).
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSelMgr As SldWorks.SelectionMgr
Dim swSeg As SldWorks.SketchSegment
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSelMgr = swModel.SelectionManager
For i = 1 To swSelMgr.GetSelectedObjectCount2(-1)
If swSelMgr.GetSelectedObjectType3(i, -1) = swSelSKETCHSEGS Then
Set swSeg = swSelMgr.GetSelectedObject6(i, -1)
Debug.Print "Art " & swSeg.GetType & ", Länge " & Format(swSeg.GetLength * 1000, "0.00") & " mm"
End If
Next i
End SubBemerkungen
Die Art kommt als Zahl aus swSketchSegments_e: 0 ist eine Linie, 1 ein Bogen. Auch ein Vollkreis ist ein Bogen. Ob ein Bogen geschlossen ist, sagt SketchArc.IsCircle.
An die speziellen Objekte kommst du so: Je nach GetType weist du das Element einer Variable vom Typ SketchLine, SketchArc und so weiter zu, etwa Set swLinie = swSeg. Ein vollständiges Beispiel steht bei SketchSegment.GetType.
Skizzenpunkte sind keine SketchSegments, sondern SketchPoint-Objekte.
Eigenschaften und Methoden
Eigenschaften 7, davon 7 beschrieben
| Name | Beschreibung |
|---|---|
| Color | Liefert oder setzt die Farbe eines Skizzenelements. Nur in Zeichnungen. |
| ConstructionGeometry | Liefert oder setzt, ob ein Skizzenelement eine Konstruktionslinie ist, etwa eine Mittellinie für eine Rotation. |
| Layer | Liefert oder setzt den Layer eines Skizzenelements. Nur in Zeichnungen. |
| LayerOverride | Liefert, in welcher Darstellung ein Skizzenelement vom Layer abweicht (Farbe, Linienart, Linienstärke), oder setzt sie auf den Layer zurück. Nur in Zeichnungen. |
| Status | Liefert, wie weit ein Skizzenelement bestimmt ist, etwa unterdefiniert oder vollständig definiert. |
| Style | Liefert oder setzt die Linienart eines Skizzenelements, etwa Mittellinie oder verdeckt. Nur in Zeichnungen. |
| Width | Liefert oder setzt die Linienstärke eines Skizzenelements. Nur in Zeichnungen. |
Methoden 24, davon 20 beschrieben, 4 veraltet
| Name | Beschreibung |
|---|---|
| CreateWireBody | Erzeugt aus dem ausgewählten Skizzenelement einen Drahtkörper. |
| DeSelect | Hebt die Auswahl eines Skizzenelements auf. |
| EqualSegment | Teilt ein Skizzenelement in gleich lange Abschnitte oder setzt gleichmäßig verteilte Punkte darauf. |
| GetConstraints | Liefert die Beziehungen eines Skizzenelements als Text, etwa "sgHORIZONTAL" oder "sgTANGENT". |
| GetCurve | Liefert die mathematische Kurve hinter einem Skizzenelement. |
| GetID | Liefert die Kennung eines Skizzenelements, ein Paar aus zwei Zahlen. |
| GetLength | Liefert die Länge eines Skizzenelements in Metern. |
| GetName | Liefert den Namen eines Skizzenelements, etwa "Linie1". |
| GetRelations | Liefert die Beziehungen eines Skizzenelements als SketchRelation-Objekte. |
| GetRelationsCount | Liefert die Anzahl der Beziehungen eines Skizzenelements. |
| GetSketch | Liefert die Skizze, zu der ein Skizzenelement gehört. |
| GetSketchPathCount | Liefert, zu wie vielen Skizzenpfaden ein Skizzenelement gehört. |
| GetSketchPaths | Liefert die Skizzenpfade, zu denen ein Skizzenelement gehört. |
| GetSketchSlot | Liefert die Nut, zu der ein Skizzenelement gehört, oder Nothing. |
| GetType | Liefert die Art eines Skizzenelements: Linie, Bogen, Ellipse, Spline, Text oder Parabel. |
| IsBendLine | Liefert, ob ein Skizzenelement eine Biegelinie ist, etwa in einem Blechteil. |
| JogLine | Fügt in die ausgewählte Linie einen rechteckigen Versatz ein. |
| Select | veraltet ersetzt durch SketchSegment.Select4 |
| Select2 | veraltet ersetzt durch SketchSegment.Select4 |
| Select3 | veraltet ersetzt durch SketchSegment.Select4 |
| Select4 | Wählt ein Skizzenelement aus, allein oder zusätzlich zur bisherigen Auswahl. |
| SelectByMark | veraltet ersetzt durch SketchSegment.Select4 |
| SelectChain | Wählt die Kette zusammenhängender Elemente aus, an der ein Skizzenelement hängt, wie „Kette auswählen“ im Kontextmenü. |
| SplitEntity | Teilt das ausgewählte Skizzenelement an einem Punkt. |
Nicht aufgeführt sind 6 C++-Varianten (Namen mit I davor, zum Beispiel IGetConstraints). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ISketchSegment in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.