SolidWorksMakroprogrammierung

Objekt · SldWorks

AnnotationView-Objekt

Eine Beschriftungsansicht in einem Teil oder einer Baugruppe: ihre Beschriftungen lesen und verschieben, die Ansicht aktivieren, ausrichten, ein- und ausblenden.

Deklaration Dim x As SldWorks.AnnotationView · in der englischen .NET-Hilfe: IAnnotationView

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

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 Sub

Bemerkungen

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

NameBeschreibung
Always2DLiefert, ob die Beschriftungen einer Beschriftungsansicht in 2D oder in 3D angezeigt werden.
AngleMadeWithViewHorizontalLiefert den Winkel, mit dem die Beschriftungsansicht waagrecht ausgerichtet wird.
AnnotationCountLiefert die Zahl der Beschriftungen in einer Beschriftungsansicht.
Annotationsveraltet ersetzt durch AnnotationView.GetAnnotations2
FlatPatternViewLiefert, ob eine Beschriftungsansicht eine Abwicklungsansicht ist.
UnassignedViewLiefert, ob eine Beschriftungsansicht keiner 3D-Ansicht zugeordnet ist.

Methoden 9, davon 9 beschrieben

NameBeschreibung
ActivateAktiviert eine Beschriftungsansicht.
ActivateAndReorientAktiviert eine Beschriftungsansicht und richtet sie aus: Du blickst senkrecht auf ihre Ebene.
GetAnnotations2Liefert die Beschriftungen einer Beschriftungsansicht, auf Wunsch nur die DimXpert-Beschriftungen.
GetViewRotationLiefert die Drehmatrix einer Beschriftungsansicht bezogen auf die XY-Ebene des Modells.
HideBlendet die Beschriftungen einer Beschriftungsansicht aus, die nicht aktiv ist.
IsShownLiefert, ob die Beschriftungen einer Beschriftungsansicht eingeblendet sind.
MoveAnnotationsVerschiebt Beschriftungen in diese Beschriftungsansicht.
OrientRichtet eine Beschriftungsansicht aus: Du blickst senkrecht auf ihre Ebene.
ShowBlendet 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.