SolidWorksMakroprogrammierung

Methode · AnnotationView

GetAnnotations2-Methode (AnnotationView)

Liefert die Beschriftungen einer Beschriftungsansicht, auf Wunsch nur die DimXpert-Beschriftungen.

Syntax

Function GetAnnotations2( _
   ByVal DimXpertOnly As Boolean, _
   ByVal UnassignedInPlane As Boolean _
) As Variant
vAnn = swAnsicht.GetAnnotations2(False, True)

Parameter

DimXpertOnlyBooleanByVal
True: nur DimXpert-Beschriftungen, False: alle Beschriftungen.
UnassignedInPlaneBooleanByVal
True: Beschriftungen auf allen Ebenen, auch auf nicht zugeordneten Ebenen. False: Beschriftungen auf allen Ebenen außer den nicht zugeordneten. Was eine nicht zugeordnete Ebene ist, sagt die Hilfe nicht.

Rückgabewert

Array der Annotation. Ohne Beschriftungen kommt Empty zurück, darum prüfst du mit IsArray oder IsEmpty.

Beispiel

' swAnsicht ist eine Beschriftungsansicht (AnnotationView), etwa aus ModelDocExtension.AnnotationViews.
Dim vAnn As Variant
Dim swAnn As SldWorks.Annotation
Dim i As Long
vAnn = swAnsicht.GetAnnotations2(False, True)
If IsArray(vAnn) Then
    For i = 0 To UBound(vAnn)
        Set swAnn = vAnn(i)
        Debug.Print swAnn.GetName & " (Typ " & swAnn.GetType & ")"   ' Typ aus swAnnotationType_e
    Next i
End If

Bemerkungen

Die Methode ersetzt die Eigenschaft AnnotationView.Annotations.

Das Hilfebeispiel „Move Annotations to Notes Area Annotation View“ aktiviert jede Ansicht mit AnnotationView.Activate, bevor es GetAnnotations2 aufruft. Nötig ist das nicht: In SOLIDWORKS 2024 lieferte die Methode die Beschriftungen auch für eine Ansicht, die nicht aktiv war.

Für die Schleife nimmst du UBound des Arrays. AnnotationView.AnnotationCount zählt die Beschriftungen der Ansicht. Ob die Zahl auch mit den Filtern passt, sagt die Hilfe nicht. Den Typ einer Beschriftung liefert Annotation.GetType als Wert aus swAnnotationType_e.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2015 SP01

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

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