Objekt · SldWorks
AnnotationView-Objekt
Eine Beschriftungsansicht in einem Teil oder einer Baugruppe: ihre Beschriftungen lesen und verschieben, die Ansicht aktivieren, ausrichten, ein- und ausblenden.
Beschreibung
AnnotationView gibt Zugriff auf die Beschriftungsansichten in Teilen und Baugruppen. Im FeatureManager stehen sie im Ordner „Beschriftungen“. Das Hilfebeispiel nennt Ansichten wie *Front, *Top, Unassigned Items und Notes Area. In welcher Beschriftungsansicht eine Beschriftung liegt, liefert Annotation.AnnotationView.
Zugriff
ModelDocExtension.AnnotationViews: alle Beschriftungsansichten eines Teils oder einer BaugruppeModelDocExtension.GetActiveAnnotationView: die aktive Beschriftungsansicht, seit SOLIDWORKS 2023 SP03ModelDocExtension.InsertAnnotationView: eine neue BeschriftungsansichtAnnotation.AnnotationView: die Beschriftungsansicht, in der eine Beschriftung liegtView3D.AnnotationViews: die Beschriftungsansichten, die einer 3D-Ansicht (MBD) zugeordnet sind
Beispiel
' Listet die Beschriftungsansichten des aktiven Modells mit ihren Beschriftungen auf.
' Vorbedingung: Ein Teil oder eine Baugruppe mit 3D-Beschriftungen ist offen.
' Ergebnis: Im Direktfenster stehen je Beschriftungsansicht Name, Zahl und Art,
' darunter die Namen ihrer Beschriftungen.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swAnsicht As SldWorks.AnnotationView
Dim swFeat As SldWorks.Feature
Dim swAnn As SldWorks.Annotation
Dim vAnsichten As Variant
Dim vAnn As Variant
Dim i As Long, j As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType = swDocDRAWING Then Exit Sub
vAnsichten = swModel.Extension.AnnotationViews
If Not IsArray(vAnsichten) Then Exit Sub
For i = 0 To UBound(vAnsichten)
Set swAnsicht = vAnsichten(i)
Set swFeat = swAnsicht ' die AnnotationView als Feature, für den Namen
Debug.Print swFeat.Name & ": " & swAnsicht.AnnotationCount & " Beschriftungen" & _
IIf(swAnsicht.IsShown, "", ", ausgeblendet") & _
IIf(swAnsicht.FlatPatternView, ", Abwicklung", "") & _
IIf(swAnsicht.UnassignedView, ", keiner 3D-Ansicht zugeordnet", "")
vAnn = swAnsicht.GetAnnotations2(False, True)
If IsArray(vAnn) Then
For j = 0 To UBound(vAnn)
Set swAnn = vAnn(j)
Debug.Print " " & swAnn.GetName
Next j
End If
Next i
End SubBemerkungen
Name: Eine AnnotationView hat keine Eigenschaft für ihren Namen. Wie in den Hilfebeispielen weist du sie einer Variablen vom Typ Feature zu und liest Feature.Name. Den Namen brauchst du etwa für Annotation.CanShowInAnnotationView. Ausgewählt wird eine Beschriftungsansicht mit ModelDocExtension.SelectByID2 und dem Typ ANNVIEW (swSelectType_e).
Aktive Ansicht: Im Hilfebeispiel „Move Annotations to Notes Area Annotation View“ aktivierst du eine Ansicht von Hand mit einem Doppelklick im Ordner „Beschriftungen“. Eine danach eingefügte Notiz landet in dieser Ansicht. Per Makro aktivierst du sie mit AnnotationView.Activate. AnnotationView.Show und AnnotationView.Hide wirken nur auf Ansichten, die nicht aktiv sind.
Aktivieren vor dem Lesen: Das Hilfebeispiel aktiviert jede Ansicht, bevor es AnnotationView.GetAnnotations2 aufruft, und die Zielansicht, bevor es AnnotationView.MoveAnnotations aufruft. Zum Lesen ist das nicht nötig, das Beispiel oben liest ohne Aktivieren.
Veraltete Befehle: AnnotationView.Annotations ist durch AnnotationView.GetAnnotations2 ersetzt (seit SOLIDWORKS 2015 SP01). Die neue Methode filtert zusätzlich nach DimXpert-Beschriftungen und nicht zugeordneten Ebenen.
Ein Teil hat ohne weiteres Zutun die Ansichten „Nichtzugewiesene Elemente“ (UnassignedView = True), „*Vorderseite“ und „*Oben“. Die Zuweisung an eine Variable vom Typ Feature klappt, Feature.GetTypeName2 liefert AnnotationViewFeat.
Eigenschaften und Methoden
Eigenschaften 6, davon 5 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| Always2D | Liefert, ob die Beschriftungen einer Beschriftungsansicht in 2D oder in 3D angezeigt werden. |
| AngleMadeWithViewHorizontal | Liefert den Winkel, mit dem die Beschriftungsansicht waagrecht ausgerichtet wird. |
| AnnotationCount | Liefert die Zahl der Beschriftungen in einer Beschriftungsansicht. |
| Annotations | veraltet ersetzt durch AnnotationView.GetAnnotations2 |
| FlatPatternView | Liefert, ob eine Beschriftungsansicht eine Abwicklungsansicht ist. |
| UnassignedView | Liefert, ob eine Beschriftungsansicht keiner 3D-Ansicht zugeordnet ist. |
Methoden 9, davon 9 beschrieben
| Name | Beschreibung |
|---|---|
| Activate | Aktiviert eine Beschriftungsansicht. |
| ActivateAndReorient | Aktiviert eine Beschriftungsansicht und richtet sie aus: Du blickst senkrecht auf ihre Ebene. |
| GetAnnotations2 | Liefert die Beschriftungen einer Beschriftungsansicht, auf Wunsch nur die DimXpert-Beschriftungen. |
| GetViewRotation | Liefert die Drehmatrix einer Beschriftungsansicht bezogen auf die XY-Ebene des Modells. |
| Hide | Blendet die Beschriftungen einer Beschriftungsansicht aus, die nicht aktiv ist. |
| IsShown | Liefert, ob die Beschriftungen einer Beschriftungsansicht eingeblendet sind. |
| MoveAnnotations | Verschiebt Beschriftungen in diese Beschriftungsansicht. |
| Orient | Richtet eine Beschriftungsansicht aus: Du blickst senkrecht auf ihre Ebene. |
| Show | Blendet die Beschriftungen einer Beschriftungsansicht ein, die nicht aktiv ist. |
Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IGetAnnotations). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IAnnotationView in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.