SolidWorksMakroprogrammierung

Methode · Sheet

InsertFamilyTable-Methode (Sheet)

Fügt eine Familientabelle in das Blatt ein.

Syntax

Function InsertFamilyTable( _
   ByVal AttachToAnchorPoint As Boolean, _
   ByVal X As Double, _
   ByVal Y As Double, _
   ByVal ModelName As String, _
   ByVal TableTemplateName As String, _
   ByVal DimColumnType As Long, _
   ByVal UseAllConfigs As Boolean, _
   ByVal ConfigArray As Variant, _
   ByVal ItemNumberStart As Long, _
   ByVal ItemNumberIncrement As Long, _
   ByVal FollowConfigTreeOrder As Boolean _
) As Object
Set swFamTabelle = swBlatt.InsertFamilyTable(False, 0.02, 0.28, "Teil1", sVorlage, swFamilyTable_MarkedForDrawing, True, Empty, 1, 1, True)

Parameter

AttachToAnchorPointBooleanByVal
True: am vorhandenen Anker für Familientabellen einfügen. False: am Punkt X, Y.
XDoubleByVal
X-Koordinate der Tabelle, vermutlich in Meter.
YDoubleByVal
Y-Koordinate der Tabelle, vermutlich in Meter.
ModelNameStringByVal
Name des Teils oder der Baugruppe, deren Familientabelle auf das Blatt kommt.
TableTemplateNameStringByVal
Pfad und Dateiname der Tabellenvorlage (*.sldfamtbt).
DimColumnTypeLongByVal
Welche Bemaßungsspalten, ein Wert aus swFamilyTableDimColumnType_e.
UseAllConfigsBooleanByVal
True: alle Konfigurationen. False: nur die aus ConfigArray.
ConfigArrayVariantByVal
Array der Konfigurationen. Gilt nur, wenn UseAllConfigs False ist.
ItemNumberStartLongByVal
Die erste Positionsnummer.
ItemNumberIncrementLongByVal
Die Schrittweite der Positionsnummern.
FollowConfigTreeOrderBooleanByVal
True: Reihenfolge wie im Konfigurationsbaum. False: nicht.

Rückgabewert

Die neue Familientabelle (FamilyTableAnnotation).

Beispiel

' swBlatt ist das aktive Zeichenblatt (Sheet), swAnsicht eine Zeichenansicht des Modells (View).
Dim swFamTabelle As SldWorks.FamilyTableAnnotation
Dim sVorlage As String
sVorlage = "C:\Program Files\SOLIDWORKS Corp\SOLIDWORKS\lang\english\family-standard.sldfamtbt"
Set swFamTabelle = swBlatt.InsertFamilyTable(False, 0.02, 0.28, swAnsicht.GetReferencedModelName, sVorlage, _
    swFamilyTable_MarkedForDrawing, True, Empty, 1, 1, True)
If swFamTabelle Is Nothing Then Debug.Print "Familientabelle nicht eingefügt"

Bemerkungen

Familientabellen zeigen die Varianten der Konfigurationen eines Teils oder einer Baugruppe oder ihre benutzerdefinierten Eigenschaften als Tabelle. Die Vorlagen liegen üblicherweise unter install_dir\lang\<Sprache> und haben die Endung .sldfamtbt; Vorlage und Tabelle müssen von derselben Art sein. Ob ModelName der Dateiname mit oder ohne Pfad ist, sagt die Hilfe nicht; das Beispiel nimmt den Modellnamen der Zeichenansicht. Was ConfigArray enthält (Namen oder Objekte), sagt sie ebenfalls nicht. Die Methode gibt es seit SOLIDWORKS 2026, ein Hilfebeispiel gibt es nicht.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2026

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

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