SolidWorksMakroprogrammierung

Methode · View

GetAnnotations-Methode (View)

Liefert alle Beschriftungen einer Zeichenansicht auf einmal als Array.

Syntax

Function GetAnnotations() As Variant
vBeschriftungen = swView.GetAnnotations

Rückgabewert

Array mit den Beschriftungen (Annotation) der Ansicht. In welcher Reihenfolge sie kommen, sagt die Hilfe nicht.

Beispiel

' swView ist eine Zeichenansicht (View), etwa aus DrawingDoc.ActiveDrawingView oder der Auswahl.
Dim vBeschriftungen As Variant
Dim swAnn As SldWorks.Annotation
Dim i As Long
If swView.GetAnnotationCount > 0 Then
    vBeschriftungen = swView.GetAnnotations
    For i = 0 To UBound(vBeschriftungen)
        Set swAnn = vBeschriftungen(i)
        If swAnn.GetType = swNote Then
            Debug.Print swAnn.GetName & " (Hinweis)"
        Else
            Debug.Print swAnn.GetName & " (Art " & swAnn.GetType & ")"
        End If
    Next i
End If

Bemerkungen

GetAnnotations ersetzt die Schleife mit View.GetFirstAnnotation3 und Annotation.GetNext3: Du bekommst alle Beschriftungen der Ansicht in einem Schritt. Die Art einer Beschriftung liest du mit Annotation.GetType (swAnnotationType_e). Brauchst du nur eine Art, nimm ab SOLIDWORKS 2025 SP02 View.GetAnnotationsByType.

Was GetAnnotations bei einer Ansicht ohne Beschriftungen liefert, sagt die Hilfe nicht. Frag deshalb vorher die Anzahl mit View.GetAnnotationCount ab, wie im Beispiel. Ob ausgeblendete Beschriftungen dabei sind, sagt die Hilfe ebenfalls nicht. Den Zustand prüfst du bei Bedarf mit Annotation.Visible.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2005

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

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