SolidWorksMakroprogrammierung

Objekt · SldWorks

SketchSegment-Objekt

Steht für ein Element einer Skizze: Linie, Bogen oder Kreis, Ellipse, Parabel oder Spline.

Deklaration Dim x As SldWorks.SketchSegment · in der englischen .NET-Hilfe: ISketchSegment

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

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 Sub

Bemerkungen

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

NameBeschreibung
ColorLiefert oder setzt die Farbe eines Skizzenelements. Nur in Zeichnungen.
ConstructionGeometryLiefert oder setzt, ob ein Skizzenelement eine Konstruktionslinie ist, etwa eine Mittellinie für eine Rotation.
LayerLiefert oder setzt den Layer eines Skizzenelements. Nur in Zeichnungen.
LayerOverrideLiefert, in welcher Darstellung ein Skizzenelement vom Layer abweicht (Farbe, Linienart, Linienstärke), oder setzt sie auf den Layer zurück. Nur in Zeichnungen.
StatusLiefert, wie weit ein Skizzenelement bestimmt ist, etwa unterdefiniert oder vollständig definiert.
StyleLiefert oder setzt die Linienart eines Skizzenelements, etwa Mittellinie oder verdeckt. Nur in Zeichnungen.
WidthLiefert oder setzt die Linienstärke eines Skizzenelements. Nur in Zeichnungen.

Methoden 24, davon 20 beschrieben, 4 veraltet

NameBeschreibung
CreateWireBodyErzeugt aus dem ausgewählten Skizzenelement einen Drahtkörper.
DeSelectHebt die Auswahl eines Skizzenelements auf.
EqualSegmentTeilt ein Skizzenelement in gleich lange Abschnitte oder setzt gleichmäßig verteilte Punkte darauf.
GetConstraintsLiefert die Beziehungen eines Skizzenelements als Text, etwa "sgHORIZONTAL" oder "sgTANGENT".
GetCurveLiefert die mathematische Kurve hinter einem Skizzenelement.
GetIDLiefert die Kennung eines Skizzenelements, ein Paar aus zwei Zahlen.
GetLengthLiefert die Länge eines Skizzenelements in Metern.
GetNameLiefert den Namen eines Skizzenelements, etwa "Linie1".
GetRelationsLiefert die Beziehungen eines Skizzenelements als SketchRelation-Objekte.
GetRelationsCountLiefert die Anzahl der Beziehungen eines Skizzenelements.
GetSketchLiefert die Skizze, zu der ein Skizzenelement gehört.
GetSketchPathCountLiefert, zu wie vielen Skizzenpfaden ein Skizzenelement gehört.
GetSketchPathsLiefert die Skizzenpfade, zu denen ein Skizzenelement gehört.
GetSketchSlotLiefert die Nut, zu der ein Skizzenelement gehört, oder Nothing.
GetTypeLiefert die Art eines Skizzenelements: Linie, Bogen, Ellipse, Spline, Text oder Parabel.
IsBendLineLiefert, ob ein Skizzenelement eine Biegelinie ist, etwa in einem Blechteil.
JogLineFügt in die ausgewählte Linie einen rechteckigen Versatz ein.
Selectveraltet ersetzt durch SketchSegment.Select4
Select2veraltet ersetzt durch SketchSegment.Select4
Select3veraltet ersetzt durch SketchSegment.Select4
Select4Wählt ein Skizzenelement aus, allein oder zusätzlich zur bisherigen Auswahl.
SelectByMarkveraltet ersetzt durch SketchSegment.Select4
SelectChainWählt die Kette zusammenhängender Elemente aus, an der ein Skizzenelement hängt, wie „Kette auswählen“ im Kontextmenü.
SplitEntityTeilt 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.