SolidWorksMakroprogrammierung

Methode · View

GetFirstAnnotation3-Methode (View)

Liefert die erste Beschriftung einer Zeichenansicht als Anfang einer Schleife über alle Beschriftungen.

Syntax

Function GetFirstAnnotation3() As Annotation
Set swAnn = swView.GetFirstAnnotation3

Rückgabewert

Die erste Beschriftung (Annotation) der Zeichenansicht. Die nächste holst du mit Annotation.GetNext3. Was zurückkommt, wenn die Ansicht keine Beschriftung hat, sagt die Hilfe nicht. Vermutlich ist es Nothing, prüf das deshalb vor der Verwendung.

Beispiel

' swView ist eine Zeichenansicht (View), etwa aus DrawingDoc.ActiveDrawingView oder der Auswahl.
Dim swAnn As SldWorks.Annotation
Dim lAlle As Long
Dim lAusgeblendet As Long
Set swAnn = swView.GetFirstAnnotation3
Do While Not swAnn Is Nothing
    lAlle = lAlle + 1
    If swAnn.Visible = swAnnotationHidden Then lAusgeblendet = lAusgeblendet + 1
    If swAnn.GetType = swNote Then Debug.Print "Hinweis: " & swAnn.GetName
    Set swAnn = swAnn.GetNext3
Loop
Debug.Print lAlle & " Beschriftungen, davon " & lAusgeblendet & " ausgeblendet"

Bemerkungen

Die Schleife liefert auch unterdrückte, ausgeblendete und hängende Bemaßungen, und zwar auf dem Blatt und auf dem Blattformat, wenn das Blattformat sichtbar ist (Sheet.SheetFormatVisible). Das Blatt muss sichtbar sein. Die Hilfe spricht an dieser Stelle nur von Bemaßungen. Ob das für alle Arten von Beschriftungen gilt, lässt sie offen.

Ausgeblendet ist eine Bemaßung, wenn du sie einzeln ausblendest oder bei einem Feature alle Bemaßungen ausblendest. Willst du solche Beschriftungen überspringen, prüfst du Annotation.Visible (swAnnotationVisibilityState_e) wie im Beispiel. Beschriftungen auf einem ausgeblendeten Layer liefert die Methode trotzdem.

Die Art der Beschriftung liest du mit Annotation.GetType (swAnnotationType_e), etwa swNote (6) oder swDisplayDimension (4). Das passende Objekt, etwa Note oder DisplayDimension, holst du mit Annotation.GetSpecificAnnotation. Alle Beschriftungen auf einmal als Array liefert View.GetAnnotations.

Beschriftungen direkt auf dem Blatt bekommst du über das Blatt selbst: DrawingDoc.GetFirstView liefert es als erstes View. Ersetzt View.GetFirstAnnotation2.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2005

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

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