SolidWorksMakroprogrammierung

Objekt · SldWorks

FamilyTableAnnotation-Objekt

Eine Familientabelle in einer Zeichnung: ihr Feature und das Zeichenblatt.

Deklaration Dim x As SldWorks.FamilyTableAnnotation · in der englischen .NET-Hilfe: IFamilyTableAnnotation

Beschreibung

FamilyTableAnnotation gibt Zugriff auf eine Familientabelle. Eine Familientabelle zeigt in einer Zeichnung die Varianten eines Teils oder einer Baugruppe als Tabelle: Konfigurationen, Bemaßungen und benutzerdefinierte Eigenschaften. Die Befehle gibt es seit SOLIDWORKS 2026.

Zugriff

Beispiel

' Geht alle Tabellen auf den Blattformaten der Zeichnung durch und gibt für jede
' Familientabelle Titel, Zeilenzahl, Blatt und Modell aus.
' Vorbedingung: Eine Zeichnung mit mindestens einer Familientabelle ist offen.
' Ergebnis:     Die Tabellen stehen im Direktfenster, die Zeichnung bleibt unverändert.
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 swTabelle As SldWorks.TableAnnotation
    Dim swFamilienTabelle As SldWorks.FamilyTableAnnotation
    Dim swFamilienFeat As SldWorks.FamilyTableFeature
    Dim vTabellen As Variant
    Dim i As Long

    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                      ' erste Ansicht ist das Blattformat
    Do While Not swView Is Nothing
        vTabellen = swView.GetTableAnnotations
        If IsArray(vTabellen) Then
            For i = 0 To UBound(vTabellen)
                Set swTabelle = vTabellen(i)
                If swTabelle.Type = swTableAnnotation_FamilyTable Then
                    Set swFamilienTabelle = swTabelle     ' dieselbe Tabelle, anderer Typ
                    Set swFamilienFeat = swFamilienTabelle.FamilyTableFeature
                    Debug.Print swTabelle.Title & ": " & swTabelle.RowCount & " Zeilen, Blatt " & _
                        swFamilienTabelle.GetSheet.GetName & ", Modell " & swFamilienFeat.GetModelName
                End If
            Next i
        End If
        Set swView = swView.GetNextView
    Loop
End Sub

Bemerkungen

Tabelle: Zeilen, Spalten und Zellen liest und setzt du über TableAnnotation. Familientabellen erkennst du an TableAnnotation.Type mit dem Wert swTableAnnotation_FamilyTable aus swTableAnnotationType_e. Dass du die Tabelle wie bei BomTableAnnotation einfach einer Variablen vom Typ FamilyTableAnnotation zuweisen kannst, sagt die Hilfe nicht. Es ist aus den anderen Tabellenarten abgeleitet.

Auswahl: Für die Auswahl kennt swSelectType_e die Typen swSelFAMILYTABLE (Tabelle) und swSelFAMILYTABLEFEAT (Feature).

Mehr dazu: Die Hilfe verweist auf die Benutzerhilfe unter „Detailing and Drawings > Tables > Family Tables“.

In SOLIDWORKS 2024 nicht prüfbar: Die Typbibliothek kennt FamilyTableAnnotation noch nicht, schon Dim x As SldWorks.FamilyTableAnnotation brach beim Kompilieren ab („Benutzerdefinierter Typ nicht definiert“). Familientabellen gibt es erst ab SOLIDWORKS 2026.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
FamilyTableFeatureLiefert das Feature der Familientabelle, zu der die Tabelle gehört.

Methoden 1, davon 1 beschrieben

NameBeschreibung
GetSheetLiefert das Zeichenblatt, auf dem die Familientabelle steht.

Siehe auch

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

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