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.
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
View.GetMultiJogLeaders: alle Bezugslinien mit mehreren Knicken einer Zeichenansicht als Array, die Anzahl mitView.GetMultiJogLeaderCountView.GetFirstMultiJogLeader2und dannMultiJogLeader.GetNext: dieselben der Reihe nach, seit SOLIDWORKS 2025 SP01Annotation.GetMultiJogLeaders: die Bezugslinien mit mehreren Knicken einer Beschriftung, die Anzahl mitAnnotation.GetMultiJogLeaderCountAnnotation.GetSpecificAnnotation: aus einer Beschriftung, wennAnnotation.GetTypeswLeader(swAnnotationType_e) liefert, so im Hilfebeispiel „Get Display Dimensions, GTols, and Surface-Finish Symbols“SelectionMgr.GetSelectedObject6: eine ausgewählte Bezugslinie mit mehreren Knicken, AuswahltypswSelLEADERS(swSelectType_e), so im Hilfebeispiel „Get Annotation Object“DrawingDoc.InsertMultiJogLeader3: fügt eine neue Bezugslinie mit mehreren Knicken ein
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| GetAnnotation | Liefert die Beschriftung, zu der die Bezugslinie mit mehreren Knicken gehört. |
| GetArrowHeadAtIndex | Liefert Lage, Richtung, Größe und Art einer Pfeilspitze der Bezugslinie mit mehreren Knicken. |
| GetArrowHeadCount | Liefert die Zahl der Pfeilspitzen der Bezugslinie mit mehreren Knicken. |
| GetDisplayData | Liefert die Darstellungsdaten der Bezugslinie mit mehreren Knicken. |
| GetLineAtIndex | Liefert Linientyp, Anfangs- und Endpunkt eines Linienstücks der Bezugslinie mit mehreren Knicken. |
| GetLineCount | Liefert die Zahl der Linienstücke der Bezugslinie mit mehreren Knicken. |
| GetNext | Liefert 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.