SolidWorksMakroprogrammierung

Methode · Annotation

SetPosition2-Methode (Annotation)

Verschiebt eine Beschriftung an eine neue Lage, angegeben als X, Y, Z ihres Bezugspunkts.

Syntax

Function SetPosition2( _
   ByVal X As Double, _
   ByVal Y As Double, _
   ByVal Z As Double _
) As Boolean
bErfolg = swAnn.SetPosition2(X, Y, Z)

Parameter

XDoubleByVal
X des Bezugspunkts.
YDoubleByVal
Y des Bezugspunkts.
ZDoubleByVal
Z des Bezugspunkts. Welcher Punkt der Bezugspunkt ist, steht bei Annotation.GetPosition. Bei Revisionswolken bestimmt ihn RevisionCloud.Shape. In Zeichnungen liegt der Ursprung in der linken unteren Ecke des Blatts. Die Werte sind in Metern.

Rückgabewert

True, wenn die Lage gesetzt wurde, sonst False.

Beispiel

' swModel ist das Dokument (ModelDoc2), swAnn eine Beschriftung (Annotation) darin.
Dim vLage As Variant
vLage = swAnn.GetPosition
If Not IsEmpty(vLage) Then
    If swAnn.SetPosition2(vLage(0) + 0.01, vLage(1), vLage(2)) Then
        swModel.ActiveView.GraphicsRedraw Empty
    End If
End If

Bemerkungen

Unterstützte Arten: Bezugshinweise, Bezugsstellensymbole, Bemaßungen, Form- und Lagetoleranzen, Notizen, Revisionswolken, Oberflächensymbole, Tabellen und Schweißsymbole. Bei anderen Arten tut der Befehl nichts und liefert False.

Einschränkungen: Wo eine Beschriftung liegen darf, ist manchmal eingeschränkt, über die API genauso wie von Hand. Ein Oberflächensymbol direkt auf einer Fläche (ohne Bezugslinie) bleibt zum Beispiel innerhalb der Fläche, eines auf einer Kante bleibt auf der Kante oder ihrer Verlängerung. Bezugshinweise haben ähnliche Grenzen. SOLIDWORKS legt die Beschriftung dann so nah wie möglich an die gewünschte Stelle.

Tabellen: Eine verankerte Tabelle lässt sich nicht verschieben. Ob sie verankert ist, liefert TableAnnotation.Anchored.

Bemaßungen mit versetztem Text: Willst du Text, Maßlinie und Maßhilfslinien verschieben, schaltest du den versetzten Text erst ab, verschiebst und schaltest ihn wieder ein. Ohne diesen Umweg bewegt der Befehl nur den Text. Bei Radius- und Durchmesserbemaßungen geht das Verschieben nicht, weil sie schon am Ende einer Bezugslinie hängen.

Siehe auch

In den Videos

Verfügbarkeit

SOLIDWORKS 2014 SP03

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

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