SolidWorksMakroprogrammierung

Objekt · SldWorks

FamilyTableFeature-Objekt

Das Feature einer Familientabelle in einer Zeichnung: Modell, gezeigte Konfigurationen, Reihenfolge, Nummerierung der Positionen und die zugehörigen Tabellen.

Deklaration Dim x As SldWorks.FamilyTableFeature · in der englischen .NET-Hilfe: IFamilyTableFeature

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

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 Sub

Bemerkungen

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

NameBeschreibung
GetConfigurationsLiefert die Konfigurationen der Familientabelle nach einem Kriterium: alle verfügbaren, nur die aktivierten oder nur die sichtbaren.
GetFeatureLiefert das übergeordnete Feature der Familientabelle, also ihren Eintrag im FeatureManager.
GetFollowConfigTreeOrderLiefert, ob die Familientabelle die Konfigurationen in der Reihenfolge des Konfigurationsbaums zeigt.
GetModelNameLiefert den Namen des Teils oder der Baugruppe, deren Familientabelle in der Zeichnung steht.
GetSequenceNumberIncrementLiefert die Schrittweite der Positionsnummern in der Familientabelle.
GetSequenceStartNumberLiefert die erste Positionsnummer der Familientabelle.
GetTableAnnotationCountLiefert die Zahl der Tabellen, die zu diesem Familientabellen-Feature gehören.
GetTableAnnotationsLiefert die Tabellen, die zu diesem Familientabellen-Feature gehören.
GetUseAllConfigurationsLiefert, ob die Familientabelle alle Konfigurationen verwendet oder nur einige.
SetConfigurationsLegt fest, welche Konfigurationen die Familientabelle verwendet und welche davon sichtbar sind.
SetFollowConfigTreeOrderLegt fest, ob die Familientabelle die Konfigurationen in der Reihenfolge des Konfigurationsbaums zeigt.
SetSequenceNumberIncrementLegt die Schrittweite der Positionsnummern in der Familientabelle fest.
SetSequenceStartNumberLegt die erste Positionsnummer der Familientabelle fest.
SetUseAllConfigurationsLegt 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.