SolidWorksMakroprogrammierung

Methode · Annotation

GetPosition-Methode (Annotation)

Liefert die Lage einer Beschriftung als X, Y, Z ihres Bezugspunkts, in Zeichnungen vom Blattursprung unten links.

Syntax

Function GetPosition() As Variant
vLage = swAnn.GetPosition

Rückgabewert

Ein Array mit drei Double-Werten: X, Y, Z des Bezugspunkts der Beschriftung. Leer, wenn es nicht geklappt hat. Die Werte sind in Metern.

Welcher Punkt das ist, hängt von der Art ab:

  • Bezugshinweis: wo die Bezugslinie auf das Symbol trifft
  • Bezugsstellensymbol: Mittelpunkt des Kreises an der Bezugslinie
  • Bemaßung: Ansatzpunkt der Bezugslinie am Textrahmen beziehungsweise Mitte der Unterkante des Textrahmens
  • Form- und Lagetoleranz: linke obere Ecke
  • Notiz: linke obere Ecke des Textrahmens
  • Oberflächensymbol: linker unterer Punkt
  • Tabelle: hängt vom Ankerpunkt ab (TableAnnotation.AnchorType)
  • Schweißsymbol: linkes Ende der waagrechten Hauptlinie

Beispiel

' swView ist eine Zeichenansicht (View), etwa aus DrawingDoc.ActiveDrawingView.
Dim swAnn As SldWorks.Annotation
Dim vLage As Variant
Set swAnn = swView.GetFirstAnnotation3
Do While Not swAnn Is Nothing
    If swAnn.GetType = swNote Then
        vLage = swAnn.GetPosition
        If Not IsEmpty(vLage) Then
            Debug.Print swAnn.GetName & ": " & Format(vLage(0) * 1000, "0.0") & " / " & _
                Format(vLage(1) * 1000, "0.0") & " mm"
        End If
    End If
    Set swAnn = swAnn.GetNext3
Loop

Bemerkungen

In einer Zeichnung liegt der Ursprung in der linken unteren Ecke des Blatts. Eine Notiz bei 50/50 mm liefert 0.05 und 0.05, die Werte sind also Meter. Das gilt auch für Beschriftungen in einer Zeichenansicht. Der Z-Wert war dort nicht 0 (etwa 0,02), er hat in Zeichnungen keine sichtbare Bedeutung. Für andere als die oben genannten Arten unterstützt der Befehl keine Lage. Prüfe das Ergebnis deshalb vor der Verwendung, wie im Beispiel.

Setzen kannst du die Lage mit Annotation.SetPosition2.

Siehe auch

In den Videos

Verfügbarkeit

SOLIDWORKS 2000

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

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