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 VariantvAnn = swAnsicht.GetAnnotations2(False, True)Parameter
DimXpertOnlyBooleanByValTrue: nur DimXpert-Beschriftungen,False: alle Beschriftungen.UnassignedInPlaneBooleanByValTrue: 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 IfBemerkungen
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.