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.
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:
- Nur lesen:
DesignTable.Attachaktiviert die Tabelle, dann liest du mit den Get-Befehlen, am Ende trennst du mitDesignTable.Detach. Attach macht SOLIDWORKS sichtbar. - Inhalt ändern:
DesignTable.EditTable2öffnet die Tabelle zum Bearbeiten und liefert das Excel-Arbeitsblatt. Dann änderst du Zellen oder fügst mitDesignTable.AddRowZeilen an.DesignTable.UpdateTablemitswUpdateDesignTableAllundTrueübernimmt die Änderungen ins Modell und schließt die Tabelle. - Einstellungen ändern: Vor dem Setzen von AutoAddNewConfigs, AutoAddNewParams, Updatable, Warn, EnableCellDropdownLists und SourceType rufst du
DesignTable.EditFeatureauf, danachDesignTable.UpdateFeature.
Attach und EditTable2 verwendest du nicht im selben Makro. Die Hilfe zieht EditTable2 vor, weil es das Arbeitsblatt liefert.
Zugriff
ModelDoc2.GetDesignTable: die Konstruktionstabelle eines Teils oder einer Baugruppe, ohne TabelleNothingModelDocExtension.HasDesignTable: vorher prüfen, ob das Dokument eine Konstruktionstabelle hatView.HasDesignTableundView.ReferencedDocument: in einer Zeichnung das Modell einer Ansicht, an dem du dann GetDesignTable aufrufstAssemblyDoc.OpenDesignTableNotifyundAssemblyDoc.CloseDesignTableNotify: die Tabelle als Argument der Ereignisse, in Teilen PartDoc.OpenDesignTableNotify und PartDoc.CloseDesignTableNotifyModelDoc2.InsertFamilyTableOpen: eine Excel-Datei als Konstruktionstabelle einfügenModelDoc2.InsertFamilyTableNew: die vorhandene Konstruktionstabelle in einer Zeichenansicht anzeigenModelDoc2.InsertFamilyTableEditundModelDoc2.CloseFamilyTable: die Tabelle in Excel zum Bearbeiten öffnen und wieder schließenModelDoc2.DeleteDesignTable: die Konstruktionstabelle löschen
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| AutoAddNewConfigs | Liest oder setzt, ob die Konstruktionstabelle automatisch Zeilen oder Spalten bekommt, wenn im Modell neue Konfigurationen entstehen. |
| AutoAddNewParams | Liest oder setzt, ob die Konstruktionstabelle automatisch Zeilen oder Spalten bekommt, wenn im Modell neue Parameter entstehen. |
| ColumnHidden | Liefert, ob eine Spalte der Konstruktionstabelle ausgeblendet ist. |
| EnableCellDropdownLists | Liest oder setzt, ob die Zellen der Konstruktionstabelle Auswahllisten haben. |
| FileName | Liest oder setzt die Excel-Datei der Konstruktionstabelle. |
| LastError | Liest den letzten Fehler einer Änderung an der Konstruktionstabelle oder setzt ihn zurück. |
| LinkToFile | Liest oder setzt, ob die Konstruktionstabelle mit ihrer Excel-Datei verknüpft ist. |
| RowHidden | Liefert, ob eine Zeile der Konstruktionstabelle ausgeblendet ist. |
| SourceType | Liest oder setzt, woher die Konstruktionstabelle stammt: ohne Quelldatei, aus einer Datei oder mit einer Datei verknüpft. |
| Updatable | Liest oder setzt, ob Änderungen am Modell die Konstruktionstabelle aktualisieren. |
| Warn | Liest oder setzt, ob SOLIDWORKS beim Aktualisieren der Konstruktionstabelle vor ungültigen Angaben warnt. |
| Worksheet | Liefert das Excel-Arbeitsblatt der Konstruktionstabelle. |
Methoden 28, davon 27 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| AddRow | Fügt der Konstruktionstabelle eine Zeile an, etwa für eine neue Konfiguration. |
| Attach | Aktiviert die Konstruktionstabelle im Teil oder in der Baugruppe, damit du sie lesen kannst. |
| Detach | Trennt 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. |
| EditTable | veraltet ersetzt durch DesignTable.EditTable2 |
| EditTable2 | Öffnet die Konstruktionstabelle zum Bearbeiten und liefert ihr Excel-Arbeitsblatt. |
| GetColumnCount | Liefert die Zahl der Spalten der Konstruktionstabelle, die gerade in der Modellansicht zu sehen sind. |
| GetEntryText | Liefert den Inhalt einer Zelle der Konstruktionstabelle als Text, unabhängig vom Datentyp der Zelle. |
| GetEntryValue | Liefert den Inhalt einer Zelle der Konstruktionstabelle mit seinem Datentyp. |
| GetHeaderText | Liefert den Text im Kopf einer Spalte der Konstruktionstabelle. |
| GetRowCount | Liefert die Zahl der Zeilen der Konstruktionstabelle, die gerade in der Modellansicht zu sehen sind. |
| GetStartColumnNumber | Liefert die Nummer der ersten Spalte, in der eine Bemaßung steht. |
| GetStartRowNumber | Liefert die Nummer der ersten Zeile, in der Bemaßungen stehen. |
| GetTitle | Liefert den Titel der Konstruktionstabelle. |
| GetTotalColumnCount | Liefert die Zahl aller Spalten der Konstruktionstabelle. |
| GetTotalRowCount | Liefert die Zahl aller Zeilen der Konstruktionstabelle. |
| GetVisibleColumnCount | Liefert die Zahl der sichtbaren Spalten der Konstruktionstabelle. |
| GetVisibleLeftColumnNumber | Liefert die Nummer der Spalte ganz links im sichtbaren Bereich der Konstruktionstabelle. |
| GetVisibleRowCount | Liefert die Zahl der sichtbaren Zeilen der Konstruktionstabelle. |
| GetVisibleTopRowNumber | Liefert die Nummer der obersten Zeile im sichtbaren Bereich der Konstruktionstabelle. |
| IsActive | Liefert, ob die Konstruktionstabelle gerade bearbeitet wird. |
| SaveAsExcelFile | Speichert die Konstruktionstabelle als Excel-Datei. |
| SetEntryText | Setzt den Text einer Zelle der Konstruktionstabelle. |
| SetEntryValue | Setzt den Wert einer Zelle der Konstruktionstabelle und dabei ihren Datentyp Text oder Standard. |
| SetRowChanged | Gibt 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.