SolidWorksMakroprogrammierung

Methode · DrawingDoc

InsertMultiJogLeader3-Methode (DrawingDoc)

Fügt eine Bezugslinie mit mehreren Knicken durch die angegebenen Punkte ein.

Syntax

Function InsertMultiJogLeader3( _
   ByVal Points As Variant, _
   ByVal StartPointArrowStyle As Long, _
   ByVal EndPointArrowStyle As Long _
) As Object
Set swLeader = swDraw.InsertMultiJogLeader3(swPunkte, swCLOSED_ARROWHEAD, swNO_ARROWHEAD)

Parameter

PointsVariantByVal
Array mit den Punkten der Linie als MathPoint-Objekte, etwa aus MathUtility.CreatePoint. Die Hilfe spricht von einem Array „der Größe PointsCount“; einen solchen Parameter gibt es in VBA nicht, gemeint ist die Länge des Arrays. Koordinatensystem und Einheit nennt die Hilfe nicht, vermutlich Blattkoordinaten in Metern.
StartPointArrowStyleLongByVal

Pfeilspitze am Startpunkt, Wert aus swArrowStyle_e, zum Beispiel:

  • swOPEN_ARROWHEAD (0): offen
  • swCLOSED_ARROWHEAD (1): gefüllt
  • swDOT_ARROWHEAD (3): gefüllter Punkt
  • swNO_ARROWHEAD (10): keine
EndPointArrowStyleLongByVal
Pfeilspitze am Endpunkt, Werte wie bei StartPointArrowStyle. Welcher Punkt Start- und welcher Endpunkt ist, sagt die Hilfe nicht; vermutlich der erste und der letzte im Array.

Rückgabewert

Die neue Bezugslinie (MultiJogLeader). Was bei einem Fehler zurückkommt, sagt die Hilfe nicht; prüf das Ergebnis mit Is Nothing.

Beispiel

' swApp ist SOLIDWORKS (SldWorks), swDraw die aktive Zeichnung (DrawingDoc).
Dim swMathUtil As SldWorks.MathUtility
Dim swLeader As SldWorks.MultiJogLeader
Dim swPunkte(3) As Object
Dim dKoord(2) As Double
Dim vXY As Variant
Dim i As Long
vXY = Array(0.05, 0.05, 0.08, 0.07, 0.12, 0.07, 0.14, 0.1)   ' x, y je Punkt in Metern
Set swMathUtil = swApp.GetMathUtility
For i = 0 To 3
    dKoord(0) = vXY(2 * i)
    dKoord(1) = vXY(2 * i + 1)
    dKoord(2) = 0
    Set swPunkte(i) = swMathUtil.CreatePoint(dKoord)
Next i
Set swLeader = swDraw.InsertMultiJogLeader3(swPunkte, swCLOSED_ARROWHEAD, swNO_ARROWHEAD)
If swLeader Is Nothing Then
    Debug.Print "Bezugslinie nicht erzeugt."
Else
    Debug.Print "Linienstücke: " & swLeader.GetLineCount
End If

Bemerkungen

Die Hilfe sagt nicht, ob vorher eine Ansicht aktiv sein muss, und auch nicht, ob die Linie an einem Element hängt. Probier es in einer Testzeichnung aus, bevor du dich auf die Lage verlässt.

Ersetzt DrawingDoc.InsertMultiJogLeader2. Vorhandene Bezugslinien dieser Art einer Ansicht liefert View.GetMultiJogLeaders, ihre Daten liest du über MultiJogLeader.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2006

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

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