SolidWorksMakroprogrammierung

Objekt · SldWorks

BomTableAnnotation-Objekt

Eine Stückliste als Tabelle: Komponenten und Pfade je Zeile, Sortieren, Unterbaugruppen auflösen, Spalten mit Eigenschaften und Export nach Excel.

Deklaration Dim x As SldWorks.BomTableAnnotation · in der englischen .NET-Hilfe: IBomTableAnnotation

Beschreibung

BomTableAnnotation gibt Zugriff auf das Feature einer Stückliste (BomFeature). Daneben hat das Objekt die Befehle, die es nur bei Stücklisten gibt: welche Komponenten in einer Zeile stehen, Sortieren, Auf- und Zuklappen, Unterbaugruppen auflösen und Spalten mit Eigenschaften füllen. Zeilen, Spalten und Zellen liest und setzt du über TableAnnotation. Dieselbe Tabelle weist du dafür einfach einer Variablen dieses Typs zu.

Zugriff

Beispiel

' Gibt für jede Zeile der ausgewählten Stückliste Positionsnummer, Teilenummer
' und die Komponenten aus.
' Vorbedingung: Eine Zeichnung mit einer Stückliste „Nur Teile“ oder „Eingerückt“ ist offen,
'               die Stückliste ist im Grafikbereich ausgewählt.
' Ergebnis:     Die Zeilen stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swObj As Object
    Dim swTabelle As SldWorks.TableAnnotation
    Dim swBomAnn As SldWorks.BomTableAnnotation
    Dim swComp As SldWorks.Component2
    Dim vKomponenten As Variant
    Dim sPosition As String, sTeil As String
    Dim nZeile As Long, i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swObj = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swObj Is SldWorks.TableAnnotation Then Exit Sub
    Set swTabelle = swObj
    If swTabelle.Type <> swTableAnnotation_BillOfMaterials Then Exit Sub
    Set swBomAnn = swTabelle                                       ' dieselbe Tabelle als Stückliste

    Debug.Print swBomAnn.BomFeature.Name
    For nZeile = 0 To swTabelle.RowCount - 1
        If swBomAnn.GetComponentsCount2(nZeile, "", sPosition, sTeil) > 0 Then
            Debug.Print sPosition & "  " & sTeil
            vKomponenten = swBomAnn.GetComponents2(nZeile, "")
            If IsArray(vKomponenten) Then
                For i = 0 To UBound(vKomponenten)
                    Set swComp = vKomponenten(i)
                    Debug.Print "    " & swComp.Name2
                Next i
            End If
        End If
    Next nZeile
End Sub

Bemerkungen

Zwei Sichten auf eine Tabelle: Die Stückliste ist zugleich eine TableAnnotation. Für Zeilen, Spalten, Zellen und den Titel nimmst du diese, für alles, was es nur bei Stücklisten gibt, BomTableAnnotation. Die Hilfebeispiele weisen das Objekt dafür jeweils der anderen Variablen zu, wie oben.

Zeilen zählen: BomTableAnnotation.GetComponents2, BomTableAnnotation.GetComponentsCount2 und BomTableAnnotation.GetModelPathNames zählen die Zeilen ab 0. Zeile 0 ist dabei der Kopf, bei sichtbarem Titel ist es Zeile 1. BomTableAnnotation.Dissolve zählt nach Angabe der Hilfe dagegen ab 1, bei BomTableAnnotation.Expand und BomTableAnnotation.Collapse sagt die Hilfe nichts dazu.

Konfiguration: Bei Stücklisten „Nur oberste Ebene“ übergibst du an GetComponents2 und GetComponentsCount2 die Konfiguration, für die du die Komponenten willst. Die Namen liefert BomFeature.GetConfigurations. Bei den anderen Arten übergibst du einen leeren Text.

Sortieren: Nach „Sorting Tables“ holst du mit BomTableAnnotation.GetBomTableSortData ein BomTableSortData, setzt Spalten und Richtung und rufst BomTableAnnotation.Sort auf. Speicherst du die Einstellungen dabei in der Stückliste, sortierst du später mit BomTableAnnotation.ApplySavedSortScheme neu.

Spalten mit Eigenschaften: Eine benutzerdefinierte Spalte füllst du mit BomTableAnnotation.SetColumnCustomProperty aus einer Eigenschaft der Komponenten. Welche Eigenschaften es gibt, liefert BomTableAnnotation.GetAllCustomProperties.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
BomFeatureLiefert das Feature der Stückliste, an dem ihre Einstellungen hängen.

Methoden 20, davon 18 beschrieben, 2 veraltet

NameBeschreibung
ApplySavedSortSchemeSortiert die Stückliste erneut nach den Einstellungen, die beim Sortieren in ihr gespeichert wurden.
CollapseKlappt eine Zeile der Stückliste zu, etwa eine Unterbaugruppe, oder alle Zuschnittslisten der Tabelle.
DissolveLöst die Unterbaugruppe oder Schweißkonstruktion in einer Zeile der Stückliste in ihre einzelnen Komponenten auf.
ExpandKlappt eine Zeile der Stückliste auf, etwa eine Unterbaugruppe, oder alle Zuschnittslisten der Tabelle.
GetAllCustomPropertiesLiefert die Eigenschaften, die du in einer Spalte der Stückliste anzeigen kannst.
GetAllCustomPropertiesCountLiefert, wie viele Eigenschaften du in einer Spalte der Stückliste anzeigen kannst.
GetBomTableSortDataLiefert ein Objekt mit Sortierdaten, mit dem du die Stückliste sortierst.
GetColumnCustomPropertyLiefert die Eigenschaft, mit der eine benutzerdefinierte Spalte der Stückliste gefüllt wird.
GetColumnUseTitleAsPartNumberLiefert, ob die Spalte für die Teilenummer den Dokumenttitel zeigt.
GetComponentsveraltet ersetzt durch BomTableAnnotation.GetComponents2
GetComponents2Liefert die Komponenten einer Zeile der Stückliste.
GetComponentsCountveraltet ersetzt durch BomTableAnnotation.GetComponentsCount2
GetComponentsCount2Liefert die Zahl der Komponenten einer Zeile der Stückliste, dazu Positionsnummer und Teilenummer.
GetModelPathNamesLiefert die vollständigen Pfade aller Dokumente einer Zeile der Stückliste, dazu Positionsnummer und Teilenummer.
GetModelPathNamesCountLiefert die Zahl der Dokumente in einer Zeile der Stückliste.
RestoreRestructuredComponentsStellt eine aufgelöste Unterbaugruppe oder Schweißkonstruktion in der Stückliste wieder her.
SaveAsExcelSpeichert die Stückliste als Excel-Datei.
SetColumnCustomPropertyLegt fest, mit welcher Eigenschaft eine benutzerdefinierte Spalte der Stückliste gefüllt wird.
SetColumnUseTitleAsPartNumberLegt fest, ob die Spalte für die Teilenummer den Dokumenttitel zeigt.
SortSortiert die Stückliste nach den angegebenen Sortierdaten.

Nicht aufgeführt sind 4 C++-Varianten (Namen mit I davor, zum Beispiel IGetAllCustomProperties). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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