SolidWorksMakroprogrammierung

Methode · Annotation

GetNext3-Methode (Annotation)

Liefert die nächste Beschriftung, für eine Schleife über alle Beschriftungen einer Zeichenansicht oder eines Modells.

Syntax

Function GetNext3() As Annotation
Set swAnn = swAnn.GetNext3

Rückgabewert

Die nächste Beschriftung (Annotation), oder Nothing, wenn es keine weitere gibt.

Beispiel

' Gibt für jede Ansicht der aktiven Zeichnung alle Beschriftungen mit Art und Name aus.
' Vorbedingung: Eine Zeichnung ist geöffnet.
' Ergebnis:     Eine Zeile je Beschriftung im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDraw As SldWorks.DrawingDoc
    Dim swView As SldWorks.View
    Dim swAnn As SldWorks.Annotation

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocDRAWING Then Exit Sub
    Set swDraw = swModel

    Set swView = swDraw.GetFirstView        ' zuerst das Blatt selbst
    Do While Not swView Is Nothing
        Debug.Print swView.GetName2
        Set swAnn = swView.GetFirstAnnotation3
        Do While Not swAnn Is Nothing
            Debug.Print "  " & swAnn.GetName & ", Art " & swAnn.GetType & _
                IIf(swAnn.Visible = swAnnotationHidden, ", ausgeblendet", "")
            Set swAnn = swAnn.GetNext3
        Loop
        Set swView = swView.GetNextView
    Loop
End Sub

Bemerkungen

Den Anfang der Schleife liefert in einer Zeichnung View.GetFirstAnnotation3, in einem Teil oder einer Baugruppe ModelDoc2.GetFirstAnnotation2.

Die Schleife findet

  • alle Bemaßungen, auch unterdrückte, ausgeblendete und hängende, auf dem Blatt und im Blattformat, wenn es sichtbar ist (Sheet.SheetFormatVisible),
  • jede einzelne Instanz einer Bemaßung: Bei einer Bemaßung „4X“ kommt die 4X-Bemaßung und dazu jede ihrer vier Instanzen,
  • auch Beschriftungen auf einem Layer, der nicht angezeigt wird.

Ausgeblendete Bemaßungen filterst du mit Annotation.Visible heraus, wie im Beispiel.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2005

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

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