SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.BomTable · in der englischen .NET-Hilfe: IBomTable

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

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 Sub

Bemerkungen

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

NameBeschreibung
Attachveraltet ersetzt durch BomTable.Attach3
Attach2veraltet ersetzt durch BomTable.Attach3
Attach3Aktiviert die Excel-Stückliste. Erst danach gehen die übrigen Befehle von BomTable.
DeSelectHebt die Auswahl der Excel-Stückliste auf.
DetachDeaktiviert die Excel-Stückliste wieder, wenn du mit ihren Befehlen fertig bist.
GetColumnCountveraltet ersetzt durch BomTable.GetTotalColumnCount
GetColumnWidthLiefert die Breite einer Spalte der Excel-Stückliste.
GetDisplayDataLiefert die Darstellungsdaten der Excel-Stückliste.
GetEntryTextLiefert den Inhalt einer Zelle der Excel-Stückliste als Text, egal welcher Art der Wert ist.
GetEntryValueLiefert den Inhalt einer Zelle der Excel-Stückliste mit seiner Art, etwa als Zahl oder Text.
GetExtentLiefert die linke untere und die rechte obere Ecke der Excel-Stückliste auf dem Zeichenblatt.
GetHeaderTextLiefert den Kopf einer Spalte der Excel-Stückliste.
GetRowCountveraltet ersetzt durch BomTable.GetTotalRowCount
GetRowHeightLiefert die Höhe einer Zeile der Excel-Stückliste, in Metern.
GetTotalColumnCountLiefert die Zahl aller Spalten der Excel-Stückliste.
GetTotalRowCountLiefert die Zahl aller Zeilen der Excel-Stückliste.
IsVisibleLiefert, ob die Excel-Stückliste sichtbar ist.
SelectWä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.