Objekt · SldWorks
BomTable-Objekt
Eine Stückliste alter Art auf Basis von Microsoft Excel: Zellen, Spaltenköpfe und Größe lesen. Neue Stücklisten sind BomTableAnnotation.
Beschreibung
BomTable gibt Zugriff auf die Daten einer Stückliste auf Basis von Microsoft Excel. Die Hilfe sagt, dass sich solche Stücklisten nicht mehr einfügen lassen, nur noch Stücklisten als SOLIDWORKS-Tabelle (BomTableAnnotation). In SOLIDWORKS 2024 fügte View.InsertBomTable mit der mitgelieferten Excel-Vorlage „Piping BOM Template.xls“ aber noch eine ein. Eine Excel-Stückliste lässt sich auch nicht in eine BomTableAnnotation umwandeln. BomTable brauchst du also nur noch für alte Stücklisten in vorhandenen Zeichnungen.
Zugriff
View.GetBomTable: die Excel-Stückliste einer ZeichenansichtView.InsertBomTable: eine neue Excel-Stückliste, nach der Hilfe nicht mehr möglich, in SOLIDWORKS 2024 aber noch
Beispiel
' Gibt Spaltenköpfe und Zellen der Excel-Stückliste der ausgewählten Zeichenansicht aus.
' Vorbedingung: Eine alte Zeichnung mit einer Stückliste auf Basis von Microsoft Excel ist offen,
' die Zeichenansicht mit der Stückliste ist ausgewählt.
' Ergebnis: Die Stückliste steht zeilenweise im Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swView As SldWorks.View
Dim swExcelBom As SldWorks.BomTable
Dim nZeile As Long, nSpalte As Long
Dim sZeile As String
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swView = swModel.SelectionManager.GetSelectedObjectsDrawingView2(1, -1)
If swView Is Nothing Then Exit Sub
Set swExcelBom = swView.GetBomTable
If swExcelBom Is Nothing Then
Debug.Print "Keine Excel-Stückliste an dieser Ansicht."
Exit Sub
End If
If False = swExcelBom.Attach3 Then Exit Sub ' macht SOLIDWORKS sichtbar
sZeile = ""
For nSpalte = 0 To swExcelBom.GetTotalColumnCount - 1
sZeile = sZeile & swExcelBom.GetHeaderText(nSpalte) & vbTab
Next nSpalte
Debug.Print sZeile
For nZeile = 1 To swExcelBom.GetTotalRowCount - 1 ' Zeile 0 ist die Kopfzeile
sZeile = ""
For nSpalte = 0 To swExcelBom.GetTotalColumnCount - 1
sZeile = sZeile & swExcelBom.GetEntryText(nZeile, nSpalte) & vbTab
Next nSpalte
Debug.Print sZeile
Next nZeile
swExcelBom.Detach
End SubBemerkungen
Aktivieren: Du rufst BomTable.Attach3 auf, bevor du einen anderen Befehl von BomTable benutzt, und am Ende BomTable.Detach. Attach3 macht SOLIDWORKS sichtbar, auch wenn es im Hintergrund läuft.
Zeilen und Spalten: Zeilen und Spalten zählen ab 0. BomTable.GetTotalRowCount und BomTable.GetTotalColumnCount liefern 0, wenn die Stückliste verdeckt ist, etwa beim Debuggen eines Makros. Das liegt an Microsoft Excel. Zeile 0 ist die Kopfzeile. Das Beispiel gibt die Köpfe mit BomTable.GetHeaderText aus und beginnt die Zeilen deshalb bei 1.
Neue Stücklisten: Stücklisten als SOLIDWORKS-Tabelle fügst du mit View.InsertBomTable6 ein und liest sie über BomTableAnnotation und TableAnnotation. View.GetBomTable liefert sie nicht.
Eigenschaften und Methoden
Methoden 18, davon 14 beschrieben, 4 veraltet
| Name | Beschreibung |
|---|---|
| Attach | veraltet ersetzt durch BomTable.Attach3 |
| Attach2 | veraltet ersetzt durch BomTable.Attach3 |
| Attach3 | Aktiviert die Excel-Stückliste. Erst danach gehen die übrigen Befehle von BomTable. |
| DeSelect | Hebt die Auswahl der Excel-Stückliste auf. |
| Detach | Deaktiviert die Excel-Stückliste wieder, wenn du mit ihren Befehlen fertig bist. |
| GetColumnCount | veraltet ersetzt durch BomTable.GetTotalColumnCount |
| GetColumnWidth | Liefert die Breite einer Spalte der Excel-Stückliste. |
| GetDisplayData | Liefert die Darstellungsdaten der Excel-Stückliste. |
| GetEntryText | Liefert den Inhalt einer Zelle der Excel-Stückliste als Text, egal welcher Art der Wert ist. |
| GetEntryValue | Liefert den Inhalt einer Zelle der Excel-Stückliste mit seiner Art, etwa als Zahl oder Text. |
| GetExtent | Liefert die linke untere und die rechte obere Ecke der Excel-Stückliste auf dem Zeichenblatt. |
| GetHeaderText | Liefert den Kopf einer Spalte der Excel-Stückliste. |
| GetRowCount | veraltet ersetzt durch BomTable.GetTotalRowCount |
| GetRowHeight | Liefert die Höhe einer Zeile der Excel-Stückliste, in Metern. |
| GetTotalColumnCount | Liefert die Zahl aller Spalten der Excel-Stückliste. |
| GetTotalRowCount | Liefert die Zahl aller Zeilen der Excel-Stückliste. |
| IsVisible | Liefert, ob die Excel-Stückliste sichtbar ist. |
| Select | Wählt die Excel-Stückliste aus und markiert sie. |
Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IGetDisplayData). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IBomTable in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.