SolidWorksMakroprogrammierung

Objekt · SldWorks

DesignTable-Objekt

Die Konstruktionstabelle eines Teils oder einer Baugruppe: eine Excel-Tabelle, die Konfigurationen und ihre Parameter steuert. Zellen lesen und schreiben, Zeilen anfügen, Einstellungen ändern und das Modell aktualisieren.

Deklaration Dim x As SldWorks.DesignTable · in der englischen .NET-Hilfe: IDesignTable

Beschreibung

DesignTable gibt Zugriff auf die Angaben und Werte einer Konstruktionstabelle (design table). Eine Konstruktionstabelle ist ein Excel-Arbeitsblatt im Teil oder in der Baugruppe, das die Konfigurationen steuert. Du fügst Zeilen für weitere Konfigurationen und Spalten für weitere Parameter hinzu, etwa Bemaßungen oder den Zustand von Features. Mit DesignTable.UpdateTable übernimmt SOLIDWORKS die Änderungen ins Modell. Wo die Hilfe eine Version nennt, reicht sie von SOLIDWORKS 99 bis 2017.

Drei Abläufe: Aus den Hinweisen der Hilfe ergeben sich drei Arten, mit der Tabelle zu arbeiten:

Attach und EditTable2 verwendest du nicht im selben Makro. Die Hilfe zieht EditTable2 vor, weil es das Arbeitsblatt liefert.

Zugriff

Beispiel

' Gibt Titel, Größe und alle Zellen der Konstruktionstabelle aus.
' Vorbedingung: Ein Teil oder eine Baugruppe mit Konstruktionstabelle ist offen.
' Ergebnis:     Die Zeilen stehen im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swTabelle As SldWorks.DesignTable
    Dim nZeilen As Long
    Dim nSpalten As Long
    Dim sZeile As String
    Dim i As Long
    Dim j As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swTabelle = swModel.GetDesignTable
    If swTabelle Is Nothing Then
        Debug.Print "Keine Konstruktionstabelle"
        Exit Sub
    End If

    If False = swTabelle.Attach Then Exit Sub
    nZeilen = swTabelle.GetTotalRowCount
    nSpalten = swTabelle.GetTotalColumnCount
    Debug.Print "Titel: """ & swTabelle.GetTitle & """, " & nZeilen & " Zeilen, " & nSpalten & " Spalten"
    For i = 0 To nZeilen                ' so im Hilfebeispiel, ab 0 bis einschließlich Anzahl
        sZeile = "|"
        For j = 0 To nSpalten
            sZeile = sZeile & swTabelle.GetEntryText(i, j) & "|"
        Next j
        Debug.Print sZeile
    Next i
    swTabelle.Detach
End Sub
' Fügt eine Zeile für die neue Konfiguration "190" an und übernimmt sie ins Modell.
' Vorbedingung: Ein Teil mit Konstruktionstabelle ist offen. Die Tabelle hat
'               nach der Spalte mit den Konfigurationsnamen eine Spalte.
' Ergebnis:     Das Teil hat die Konfiguration "190".
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swTabelle As SldWorks.DesignTable
    Dim sZellen(1) As String
    Dim bOk As Boolean

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swTabelle = swModel.GetDesignTable
    If swTabelle Is Nothing Then Exit Sub

    sZellen(0) = "190"                  ' Name der Konfiguration
    sZellen(1) = "S"                    ' Wert für die nächste Spalte

    swTabelle.EditTable2 False          ' Arbeitsblatt nicht in einer Variablen halten
    bOk = swTabelle.AddRow((sZellen))
    If False = swTabelle.UpdateTable(swUpdateDesignTableAll, True) Then
        Debug.Print "Nicht übernommen, Fehler " & swTabelle.LastError
    End If
End Sub

Bemerkungen

Hilfebeispiele: „Get Design Table“ liest die Tabelle wie das erste Beispiel oben mit Attach und Detach. „Add Row to Design Table“ fügt eine Zeile an, ruft dafür aber den veralteten Befehl DesignTable.EditTable auf. Das zweite Beispiel oben nimmt stattdessen DesignTable.EditTable2. „Get Excel Design Table Worksheet“ holt das Arbeitsblatt mit DesignTable.Worksheet und liest Zeilenhöhen, Spaltenbreiten und Zellformate über die Excel-API. „Save Design Table as Microsoft Excel File“ speichert die Tabelle mit DesignTable.SaveAsExcelFile.

Zählung der Zeilen und Spalten: Die Hilfe ist hier nicht einheitlich. Bei DesignTable.GetEntryText, DesignTable.GetEntryValue und DesignTable.GetHeaderText zählen Zeilen und Spalten ab 0. Bei DesignTable.RowHidden und DesignTable.ColumnHidden ist 1 die erste Zeile oder Spalte. Zu DesignTable.GetTotalRowCount und DesignTable.GetTotalColumnCount sagt die Hilfe, der Index laufe von 1 bis zur Anzahl, das Hilfebeispiel liest aber von 0 bis einschließlich der Anzahl. Zeile 0 ist die Zeile mit den Parameternamen und Spalte 0 die Spalte mit den Konfigurationsnamen. GetTotalRowCount und GetTotalColumnCount zählen beide nicht mit, deshalb liest das Hilfebeispiel richtig bis einschließlich der Anzahl. DesignTable.SetEntryText zählt genauso.

Sichtbar und gesamt: DesignTable.GetRowCount und DesignTable.GetColumnCount zählen nur, was gerade in der Modellansicht zu sehen ist, die GetTotal-Befehle alles. Was in der Modellansicht hier genau heißt und wie sich GetRowCount von DesignTable.GetVisibleRowCount unterscheidet, sagt die Hilfe nicht. Im Hilfebeispiel beziehen sich die GetVisible-Befehle auf das Excel-Arbeitsblatt, die GetTotal- und GetStart-Befehle auf die Daten der Tabelle. Für alles außerhalb des sichtbaren Bereichs verweist die Hilfe auf das Arbeitsblatt und die Excel-API.

Arbeitsblatt freigeben: Hast du das Ergebnis von DesignTable.EditTable2 einer Variablen zugewiesen, gibst du sie vor UpdateTable(…, True) frei, also Set xlBlatt = Nothing. Mit NewWindow = True vermeidest du Probleme beim Zoomen. Willst du das Arbeitsblatt als Excel.Worksheet deklarieren wie in den Hilfebeispielen, brauchst du einen Verweis auf die Microsoft-Excel-Objektbibliothek. Mit As Object geht es ohne.

SOLIDWORKS im Hintergrund: DesignTable.Attach macht SOLIDWORKS sichtbar. Läuft SOLIDWORKS unsichtbar im Hintergrund, verwendest du Attach nicht.

Zeichnungen: In einer Zeichnung liefert ModelDoc2.GetDesignTable Nothing. Das Hilfebeispiel „Get Excel Design Table Worksheet“ läuft deshalb über die Ansichten, holt mit View.GetReferencedModelName das Modell, aktiviert es und ruft GetDesignTable daran auf.

Parameter ohne Tabelle: Die Parameter einer Konfiguration, wie sie in einer Konstruktionstabelle stünden, liest du auch ohne Tabelle mit ConfigurationManager.GetConfigurationParams und Configuration.GetParameters. Ob eine Tabelle eine Bemaßung steuert, liefert Dimension.IsDesignTableDimension.

Eine mit ModelDoc2.InsertFamilyTableOpen aus einer Excel-Datei eingefügte Tabelle kann ohne Parameterspalten ankommen: DesignTable.GetTotalColumnCount liefert dann 0, und DesignTable.UpdateTable scheitert mit DesignTable.LastError 24 (swDTblTableIsEmpty).

Eigenschaften und Methoden

Eigenschaften 12, davon 12 beschrieben

NameBeschreibung
AutoAddNewConfigsLiest oder setzt, ob die Konstruktionstabelle automatisch Zeilen oder Spalten bekommt, wenn im Modell neue Konfigurationen entstehen.
AutoAddNewParamsLiest oder setzt, ob die Konstruktionstabelle automatisch Zeilen oder Spalten bekommt, wenn im Modell neue Parameter entstehen.
ColumnHiddenLiefert, ob eine Spalte der Konstruktionstabelle ausgeblendet ist.
EnableCellDropdownListsLiest oder setzt, ob die Zellen der Konstruktionstabelle Auswahllisten haben.
FileNameLiest oder setzt die Excel-Datei der Konstruktionstabelle.
LastErrorLiest den letzten Fehler einer Änderung an der Konstruktionstabelle oder setzt ihn zurück.
LinkToFileLiest oder setzt, ob die Konstruktionstabelle mit ihrer Excel-Datei verknüpft ist.
RowHiddenLiefert, ob eine Zeile der Konstruktionstabelle ausgeblendet ist.
SourceTypeLiest oder setzt, woher die Konstruktionstabelle stammt: ohne Quelldatei, aus einer Datei oder mit einer Datei verknüpft.
UpdatableLiest oder setzt, ob Änderungen am Modell die Konstruktionstabelle aktualisieren.
WarnLiest oder setzt, ob SOLIDWORKS beim Aktualisieren der Konstruktionstabelle vor ungültigen Angaben warnt.
WorksheetLiefert das Excel-Arbeitsblatt der Konstruktionstabelle.

Methoden 28, davon 27 beschrieben, 1 veraltet

NameBeschreibung
AddRowFügt der Konstruktionstabelle eine Zeile an, etwa für eine neue Konfiguration.
AttachAktiviert die Konstruktionstabelle im Teil oder in der Baugruppe, damit du sie lesen kannst.
DetachTrennt die Konstruktionstabelle wieder vom Excel-Arbeitsblatt, nachdem du sie mit Attach gelesen hast.
EditFeatureÖffnet die Einstellungen der Konstruktionstabelle zum Ändern, etwa Updatable oder Warn.
EditTableveraltet ersetzt durch DesignTable.EditTable2
EditTable2Öffnet die Konstruktionstabelle zum Bearbeiten und liefert ihr Excel-Arbeitsblatt.
GetColumnCountLiefert die Zahl der Spalten der Konstruktionstabelle, die gerade in der Modellansicht zu sehen sind.
GetEntryTextLiefert den Inhalt einer Zelle der Konstruktionstabelle als Text, unabhängig vom Datentyp der Zelle.
GetEntryValueLiefert den Inhalt einer Zelle der Konstruktionstabelle mit seinem Datentyp.
GetHeaderTextLiefert den Text im Kopf einer Spalte der Konstruktionstabelle.
GetRowCountLiefert die Zahl der Zeilen der Konstruktionstabelle, die gerade in der Modellansicht zu sehen sind.
GetStartColumnNumberLiefert die Nummer der ersten Spalte, in der eine Bemaßung steht.
GetStartRowNumberLiefert die Nummer der ersten Zeile, in der Bemaßungen stehen.
GetTitleLiefert den Titel der Konstruktionstabelle.
GetTotalColumnCountLiefert die Zahl aller Spalten der Konstruktionstabelle.
GetTotalRowCountLiefert die Zahl aller Zeilen der Konstruktionstabelle.
GetVisibleColumnCountLiefert die Zahl der sichtbaren Spalten der Konstruktionstabelle.
GetVisibleLeftColumnNumberLiefert die Nummer der Spalte ganz links im sichtbaren Bereich der Konstruktionstabelle.
GetVisibleRowCountLiefert die Zahl der sichtbaren Zeilen der Konstruktionstabelle.
GetVisibleTopRowNumberLiefert die Nummer der obersten Zeile im sichtbaren Bereich der Konstruktionstabelle.
IsActiveLiefert, ob die Konstruktionstabelle gerade bearbeitet wird.
SaveAsExcelFileSpeichert die Konstruktionstabelle als Excel-Datei.
SetEntryTextSetzt den Text einer Zelle der Konstruktionstabelle.
SetEntryValueSetzt den Wert einer Zelle der Konstruktionstabelle und dabei ihren Datentyp Text oder Standard.
SetRowChangedGibt an, welche Zeile der Konstruktionstabelle sich geändert hat, damit das Aktualisieren schneller geht.
UpdateFeatureÜbernimmt die geänderten Einstellungen der Konstruktionstabelle nach EditFeature.
UpdateModelÜbernimmt die Änderungen an der Konstruktionstabelle ins Modell, als vereinfachte Form von UpdateTable.
UpdateTableÜbernimmt die Änderungen an der Konstruktionstabelle ins Modell und schließt die Tabelle auf Wunsch.

Siehe auch

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

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