Objekt · SldWorks
FamilyTableFeature-Objekt
Das Feature einer Familientabelle in einer Zeichnung: Modell, gezeigte Konfigurationen, Reihenfolge, Nummerierung der Positionen und die zugehörigen Tabellen.
Beschreibung
FamilyTableFeature gibt Zugriff auf das Feature einer Familientabelle. Familientabellen zeigen in einer Zeichnung die Varianten der Konfigurationen eines Teils oder einer Baugruppe oder ihre benutzerdefinierten Eigenschaften als Tabelle. Das Feature hält die Einstellungen der Tabelle und verbindet den Eintrag im FeatureManager (Feature) mit den Tabellen auf dem Blatt (FamilyTableAnnotation). Die Befehle gibt es seit SOLIDWORKS 2026.
Zugriff
FamilyTableAnnotation.FamilyTableFeature: das Feature einer Familientabelle, etwa ausSheet.InsertFamilyTableoder aus den Tabellen einer Zeichenansicht
Eine Familientabelle erkennst du an TableAnnotation.Type mit dem Wert swTableAnnotation_FamilyTable. In der Auswahl hat das Feature den Typ swSelFAMILYTABLEFEAT (Typname FamilyTableFeat, swSelectType_e). Welches Objekt SelectionMgr.GetSelectedObject6 dann liefert, sagt die Hilfe nicht.
Beispiel
' Gibt für jede Familientabelle der Zeichnung Modell, Konfigurationen, Reihenfolge
' und Nummerierung ihres Features aus.
' Vorbedingung: Eine Zeichnung mit mindestens einer Familientabelle ist offen.
' Ergebnis: Die Werte 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 vKonfig As Variant
Dim i As Long
Dim j 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 swFamilienFeat.GetFeature.Name & ": Modell " & swFamilienFeat.GetModelName & _
", " & swFamilienFeat.GetTableAnnotationCount & " Tabelle(n)"
Debug.Print " Alle Konfigurationen: " & swFamilienFeat.GetUseAllConfigurations & _
", Reihenfolge wie Konfigurationsbaum: " & swFamilienFeat.GetFollowConfigTreeOrder
Debug.Print " Positionen ab " & swFamilienFeat.GetSequenceStartNumber & _
", Schritt " & swFamilienFeat.GetSequenceNumberIncrement
vKonfig = swFamilienFeat.GetConfigurations(GetJustVisibleConfigurationNames)
If IsArray(vKonfig) Then
For j = 0 To UBound(vKonfig)
Debug.Print " sichtbar: " & vKonfig(j)
Next j
End If
End If
Next i
End If
Set swView = swView.GetNextView
Loop
End SubBemerkungen
Einfügen: Sheet.InsertFamilyTable nimmt dieselben Einstellungen als Parameter: UseAllConfigs, ConfigArray, ItemNumberStart, ItemNumberIncrement und FollowConfigTreeOrder. Mit den Set-Befehlen hier änderst du sie danach. Ob die Tabelle danach sofort neu aufgebaut wird, sagt die Hilfe nicht.
Konfigurationen: FamilyTableFeature.SetConfigurations gilt nur, wenn FamilyTableFeature.GetUseAllConfigurations False liefert. Welche Konfigurationen FamilyTableFeature.GetConfigurations liefert, wählst du mit swFamilyTableGetConfigurationCriteria_e: alle verfügbaren, nur die aktivierten oder nur die sichtbaren. Dem Namen der Werte nach sind es die Namen der Konfigurationen.
Hilfebeispiele: Zu FamilyTableFeature gibt es keine. Das Beispiel oben ist aus der Seite zu FamilyTableAnnotation abgeleitet.
Mehr dazu: Die Hilfe verweist auf die Benutzerhilfe unter „Detailing and Drawings > Tables > Family Tables“.
In SOLIDWORKS 2024 nicht prüfbar: Die Typbibliothek kennt FamilyTableFeature noch nicht, schon Dim x As SldWorks.FamilyTableFeature brach beim Kompilieren ab („Benutzerdefinierter Typ nicht definiert“). Familientabellen gibt es erst ab SOLIDWORKS 2026.
Eigenschaften und Methoden
Methoden 14, davon 14 beschrieben
| Name | Beschreibung |
|---|---|
| GetConfigurations | Liefert die Konfigurationen der Familientabelle nach einem Kriterium: alle verfügbaren, nur die aktivierten oder nur die sichtbaren. |
| GetFeature | Liefert das übergeordnete Feature der Familientabelle, also ihren Eintrag im FeatureManager. |
| GetFollowConfigTreeOrder | Liefert, ob die Familientabelle die Konfigurationen in der Reihenfolge des Konfigurationsbaums zeigt. |
| GetModelName | Liefert den Namen des Teils oder der Baugruppe, deren Familientabelle in der Zeichnung steht. |
| GetSequenceNumberIncrement | Liefert die Schrittweite der Positionsnummern in der Familientabelle. |
| GetSequenceStartNumber | Liefert die erste Positionsnummer der Familientabelle. |
| GetTableAnnotationCount | Liefert die Zahl der Tabellen, die zu diesem Familientabellen-Feature gehören. |
| GetTableAnnotations | Liefert die Tabellen, die zu diesem Familientabellen-Feature gehören. |
| GetUseAllConfigurations | Liefert, ob die Familientabelle alle Konfigurationen verwendet oder nur einige. |
| SetConfigurations | Legt fest, welche Konfigurationen die Familientabelle verwendet und welche davon sichtbar sind. |
| SetFollowConfigTreeOrder | Legt fest, ob die Familientabelle die Konfigurationen in der Reihenfolge des Konfigurationsbaums zeigt. |
| SetSequenceNumberIncrement | Legt die Schrittweite der Positionsnummern in der Familientabelle fest. |
| SetSequenceStartNumber | Legt die erste Positionsnummer der Familientabelle fest. |
| SetUseAllConfigurations | Legt fest, ob die Familientabelle alle Konfigurationen verwendet. |
Siehe auch
Englisches Original: IFamilyTableFeature in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.