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.
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
View.InsertBomTable6: eine neue Stückliste in einer ZeichnungModelDocExtension.InsertBomTable4: eine neue Stückliste in einem Teil oder einer BaugruppeBomFeature.GetTableAnnotations: die Tabellen einer Stückliste- eine
TableAnnotationvom TypswTableAnnotation_BillOfMaterials, etwa ausView.GetTableAnnotationsoder der Auswahl, weist du nach „Sorting Tables“ einer Variablen vom Typ BomTableAnnotation zu
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| BomFeature | Liefert das Feature der Stückliste, an dem ihre Einstellungen hängen. |
Methoden 20, davon 18 beschrieben, 2 veraltet
| Name | Beschreibung |
|---|---|
| ApplySavedSortScheme | Sortiert die Stückliste erneut nach den Einstellungen, die beim Sortieren in ihr gespeichert wurden. |
| Collapse | Klappt eine Zeile der Stückliste zu, etwa eine Unterbaugruppe, oder alle Zuschnittslisten der Tabelle. |
| Dissolve | Löst die Unterbaugruppe oder Schweißkonstruktion in einer Zeile der Stückliste in ihre einzelnen Komponenten auf. |
| Expand | Klappt eine Zeile der Stückliste auf, etwa eine Unterbaugruppe, oder alle Zuschnittslisten der Tabelle. |
| GetAllCustomProperties | Liefert die Eigenschaften, die du in einer Spalte der Stückliste anzeigen kannst. |
| GetAllCustomPropertiesCount | Liefert, wie viele Eigenschaften du in einer Spalte der Stückliste anzeigen kannst. |
| GetBomTableSortData | Liefert ein Objekt mit Sortierdaten, mit dem du die Stückliste sortierst. |
| GetColumnCustomProperty | Liefert die Eigenschaft, mit der eine benutzerdefinierte Spalte der Stückliste gefüllt wird. |
| GetColumnUseTitleAsPartNumber | Liefert, ob die Spalte für die Teilenummer den Dokumenttitel zeigt. |
| GetComponents | veraltet ersetzt durch BomTableAnnotation.GetComponents2 |
| GetComponents2 | Liefert die Komponenten einer Zeile der Stückliste. |
| GetComponentsCount | veraltet ersetzt durch BomTableAnnotation.GetComponentsCount2 |
| GetComponentsCount2 | Liefert die Zahl der Komponenten einer Zeile der Stückliste, dazu Positionsnummer und Teilenummer. |
| GetModelPathNames | Liefert die vollständigen Pfade aller Dokumente einer Zeile der Stückliste, dazu Positionsnummer und Teilenummer. |
| GetModelPathNamesCount | Liefert die Zahl der Dokumente in einer Zeile der Stückliste. |
| RestoreRestructuredComponents | Stellt eine aufgelöste Unterbaugruppe oder Schweißkonstruktion in der Stückliste wieder her. |
| SaveAsExcel | Speichert die Stückliste als Excel-Datei. |
| SetColumnCustomProperty | Legt fest, mit welcher Eigenschaft eine benutzerdefinierte Spalte der Stückliste gefüllt wird. |
| SetColumnUseTitleAsPartNumber | Legt fest, ob die Spalte für die Teilenummer den Dokumenttitel zeigt. |
| Sort | Sortiert 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.