SolidWorksMakroprogrammierung

Methode · Annotation

ConvertToMultiJog-Methode (Annotation)

Macht aus einer Bezugslinie einer Notiz eine Bezugslinie mit mehreren Knicken an den angegebenen Knickpunkten.

Syntax

Function ConvertToMultiJog( _
   ByVal LeaderNumber As Long, _
   ByVal NumberOfPoints As Long, _
   ByVal PointsData As Variant _
) As Boolean
bErfolg = swAnn.ConvertToMultiJog(LeaderNumber, NumberOfPoints, PointsData)

Parameter

LeaderNumberLongByVal
Nummer der Bezugslinie, beginnend bei 0.
NumberOfPointsLongByVal
Anzahl der Knickpunkte.
PointsDataVariantByVal
Array aus 3 * NumberOfPoints Werten vom Typ Double: X, Y, Z jedes Knickpunkts in Blattkoordinaten. Eine Einheit nennt die Hilfe nicht, es sind Meter.

Rückgabewert

True, wenn die Bezugslinie umgewandelt wurde, sonst False. Getestet kam auch bei Erfolg False, siehe Bemerkungen.

Beispiel

' swAnn ist die Beschriftung (Annotation) einer Notiz mit Bezugslinie, etwa aus der Auswahl.
Dim aPunkte(5) As Double
Dim vPunkte As Variant
aPunkte(0) = 0.19: aPunkte(1) = 0.25: aPunkte(2) = 0     ' 1. Knick
aPunkte(3) = 0.25: aPunkte(4) = 0.19: aPunkte(5) = 0     ' 2. Knick
vPunkte = aPunkte
swAnn.ConvertToMultiJog 0, 2, vPunkte          ' Rückgabewert unzuverlässig, siehe Bemerkungen
Debug.Print swAnn.GetMultiJogLeaderCount & " Bezugslinien mit mehreren Knicken"

Bemerkungen

Der Befehl gilt für Notizen mit Bezugslinie. Die Punkte liegen in Blattkoordinaten. Das Beispiel der Hilfe übergibt zwei Punkte, legt dafür aber ein Array mit sieben statt sechs Werten an. Das Beispiel hier nimmt genau sechs.

Der Befehl liefert False, wandelt die Bezugslinie aber trotzdem um; prüfe das Ergebnis darum mit Annotation.GetMultiJogLeaderCount. Dabei entsteht eine eigene Beschriftung der Art swLeader, und Annotation.GetLeaderCount der Notiz bleibt unverändert.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2007

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

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