SolidWorksMakroprogrammierung

Objekt · SldWorks

MultiJogLeader-Objekt

Eine Bezugslinie mit mehreren Knicken in einer Zeichnung: ihre Linienstücke und Pfeilspitzen, ihre Darstellungsdaten, die zugehörige Beschriftung und die nächste Bezugslinie dieser Art in der Ansicht.

Deklaration Dim x As SldWorks.MultiJogLeader · in der englischen .NET-Hilfe: IMultiJogLeader

Beschreibung

MultiJogLeader gibt Zugriff auf die Darstellung einer Bezugslinie mit mehreren Knicken (multi-jog leader). Eine solche Bezugslinie läuft als Linienzug über mehrere Punkte und kann am Start- und am Endpunkt eine Pfeilspitze haben. Alle Befehle liefern nur Angaben. Die Befehle gibt es seit SOLIDWORKS 2001Plus.

Zugriff

Beispiel

' Listet alle Bezugslinien mit mehreren Knicken auf dem aktiven Blatt auf: Name,
' Linienstücke mit Anfangs- und Endpunkt und Pfeilspitzen mit Lage und Art.
' Vorbedingung: Eine Zeichnung mit mindestens einer Bezugslinie mit mehreren Knicken
'               ist offen.
' Ergebnis:     Die Angaben stehen im Direktfenster (Strg+G), x und y in mm.
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 swBezugslinie As SldWorks.MultiJogLeader
    Dim vListe As Variant
    Dim vLinie As Variant
    Dim vPfeil As Variant
    Dim i As Long, j 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.GetFirstView            ' zuerst das Blatt selbst
    Do While Not swView Is Nothing
        If swView.GetMultiJogLeaderCount > 0 Then
            vListe = swView.GetMultiJogLeaders
            For i = 0 To UBound(vListe)
                Set swBezugslinie = vListe(i)
                Debug.Print swView.GetName2 & ": " & swBezugslinie.GetAnnotation.GetName
                For j = 0 To swBezugslinie.GetLineCount - 1
                    vLinie = swBezugslinie.GetLineAtIndex(j)
                    If Not IsEmpty(vLinie) Then
                        Debug.Print "  Linie " & j & ": " & Format(vLinie(1) * 1000#, "0.0") & " / " & _
                            Format(vLinie(2) * 1000#, "0.0") & " bis " & Format(vLinie(4) * 1000#, "0.0") & _
                            " / " & Format(vLinie(5) * 1000#, "0.0") & ", Linientyp " & vLinie(0)
                    End If
                Next j
                For j = 0 To swBezugslinie.GetArrowHeadCount - 1
                    vPfeil = swBezugslinie.GetArrowHeadAtIndex(j)
                    If Not IsEmpty(vPfeil) Then
                        Debug.Print "  Pfeilspitze " & j & ": " & Format(vPfeil(0) * 1000#, "0.0") & " / " & _
                            Format(vPfeil(1) * 1000#, "0.0") & ", Art " & vPfeil(8)
                    End If
                Next j
            Next i
        End If
        Set swView = swView.GetNextView
    Loop
End Sub

Bemerkungen

Hilfebeispiel: „Get Multi-jog Leader Data“ holt in der ersten Zeichenansicht mit View.GetFirstMultiJogLeader2 die erste Bezugslinie mit mehreren Knicken. Es gibt Name und Typ der Beschriftung aus. Der Kommentar nennt als Typ 11 für diese Bezugslinie, das ist swLeader aus swAnnotationType_e. Danach gibt es die Linienstücke und die Zahl der Pfeilspitzen aus.

Nummern und Koordinaten: Ob MultiJogLeader.GetLineAtIndex und MultiJogLeader.GetArrowHeadAtIndex bei 0 oder bei 1 zu zählen beginnen, sagt die Hilfe nicht. Die Zählung beginnt bei 0. Einheit und Koordinatensystem der Punkte nennt die Hilfe nicht. Es sind Meter in Blattkoordinaten wie bei Annotation.ConvertToMultiJog (eine mit DrawingDoc.InsertMultiJogLeader3 durch (0,05; 0,05), (0,08; 0,07) … angelegte Bezugslinie lieferte genau diese Punkte).

Anlegen und ändern: MultiJogLeader hat nur lesende Befehle. Eine neue Bezugslinie mit mehreren Knicken fügst du mit DrawingDoc.InsertMultiJogLeader3 ein und legst dabei die Pfeilspitzen am Start- und am Endpunkt fest. Die Bezugslinie einer Notiz wandelst du mit Annotation.ConvertToMultiJog in eine mit mehreren Knicken um. Annotation.GetArrowHeadCount zählt auch die Pfeilspitzen solcher Bezugslinien. Ob die übrigen Pfeilspitzen-Befehle von Annotation, etwa Annotation.SetArrowHeadStyleAtIndex, für sie gelten, sagt die Hilfe nicht.

Versionen: View.GetFirstMultiJogLeader2 gibt es erst seit SOLIDWORKS 2025 SP01. Es unterstützt im Unterschied zum veralteten Vorgänger View.GetFirstMultiJogLeader auch inaktive Blätter. In älteren Versionen nimmst du View.GetMultiJogLeaders wie im Beispiel oben, das es seit SOLIDWORKS 2009 SP01 gibt.

Eigenschaften und Methoden

Methoden 7, davon 7 beschrieben

NameBeschreibung
GetAnnotationLiefert die Beschriftung, zu der die Bezugslinie mit mehreren Knicken gehört.
GetArrowHeadAtIndexLiefert Lage, Richtung, Größe und Art einer Pfeilspitze der Bezugslinie mit mehreren Knicken.
GetArrowHeadCountLiefert die Zahl der Pfeilspitzen der Bezugslinie mit mehreren Knicken.
GetDisplayDataLiefert die Darstellungsdaten der Bezugslinie mit mehreren Knicken.
GetLineAtIndexLiefert Linientyp, Anfangs- und Endpunkt eines Linienstücks der Bezugslinie mit mehreren Knicken.
GetLineCountLiefert die Zahl der Linienstücke der Bezugslinie mit mehreren Knicken.
GetNextLiefert die nächste Bezugslinie mit mehreren Knicken in der Zeichenansicht.

Nicht aufgeführt sind 5 C++-Varianten (Namen mit I davor, zum Beispiel IGetAnnotation). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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