Methode · View
GetFirstAnnotation3-Methode (View)
Liefert die erste Beschriftung einer Zeichenansicht als Anfang einer Schleife über alle Beschriftungen.
Syntax
Function GetFirstAnnotation3() As AnnotationSet swAnn = swView.GetFirstAnnotation3Rü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.