Objekt · SldWorks
FamilyTableAnnotation-Objekt
Eine Familientabelle in einer Zeichnung: ihr Feature und das Zeichenblatt.
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
FamilyTableFeature.GetTableAnnotations: alle Tabellen eines Familientabellen-FeaturesSheet.InsertFamilyTable: fügt eine Familientabelle in ein Zeichenblatt ein und liefert sie
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| FamilyTableFeature | Liefert das Feature der Familientabelle, zu der die Tabelle gehört. |
Methoden 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| GetSheet | Liefert 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.