Methode · View
InsertBomTable-Methode (View)
Fügt für die Zeichenansicht eine Stückliste auf Basis von Microsoft Excel ein.
Syntax
Function InsertBomTable( _
ByVal Template As String, _
ByVal Xloc As Double, _
ByVal Yloc As Double, _
ByRef Errors As Long _
) As ObjectSet swExcelBom = swView.InsertBomTable("", 0.02, 0.28, lFehler)Parameter
TemplateStringByVal- Vollständiger Pfad der Excel-Vorlage für die Stückliste. Gibst du nur einen Dateinamen ohne Ordner an, sucht SOLIDWORKS in
install_dir\lang\<Sprache der Installation>. Bei leerem Text nimmt SOLIDWORKS die Dateibomtemp.xlsaus diesem Ordner. XlocDoubleByVal- X-Koordinate des Punkts auf der Zeichnung, an dem die Stückliste verankert wird. Die Hilfe nennt keine Einheit, vermutlich Meter.
YlocDoubleByVal- Y-Koordinate dieses Punkts, sonst wie Xloc.
ErrorsLongByRef · RückgabeSOLIDWORKS schreibt das Ergebnis als Wert aus
swBOMConfigurationCreationErrors_ehinein:swBOMTableCreation_Okay(0): Stückliste erstelltswBOMTableCreation_UnspecifiedError(-1): Fehler aus unbekanntem GrundswBOMTableCreation_MustBeDrawingView(-2): geht nur bei einer ZeichenansichtswBOMTableCreation_AlreadyExists(-3): die Ansicht hat schon eine StücklisteswBOMTableCreation_ExcelDisabled(-4): Excel ist auf diesem Rechner deaktiviertswBOMTableCreation_Failed(-5): die Vorlage ist ungültigswBOMTableCreation_NoModelForView(-6): zur Ansicht gibt es kein Modell
Rückgabewert
Die Stückliste (BomTable). Schlägt das Erstellen fehl, ist der Wert Nothing. Den Grund liefert dann Errors.
Beispiel
' swView ist eine Zeichenansicht einer Baugruppe (View), etwa aus DrawingDoc.ActiveDrawingView.
Dim swExcelBom As SldWorks.BomTable
Dim lFehler As Long
' Leerer Vorlagenname: bomtemp.xls aus dem Sprachordner der Installation
Set swExcelBom = swView.InsertBomTable("", 0.02, 0.28, lFehler)
If Not swExcelBom Is Nothing Then
Debug.Print "Excel-Stückliste eingefügt."
ElseIf lFehler = swBOMTableCreation_AlreadyExists Then
Debug.Print "Die Ansicht hat schon eine Stückliste."
ElseIf lFehler = swBOMTableCreation_ExcelDisabled Then
Debug.Print "Excel ist deaktiviert."
Else
Debug.Print "Keine Stückliste, Fehlercode " & lFehler
End IfBemerkungen
Die Hilfe zu BomTable sagt, dass sich solche Excel-Stücklisten nicht mehr einfügen lassen, nur noch Stücklisten als SOLIDWORKS-Tabelle (BomTableAnnotation). Die BomTable-Befehle sind nur noch für alte Stücklisten gedacht. In SOLIDWORKS 2024 fügte der Befehl mit der mitgelieferten Excel-Vorlage „Piping BOM Template.xls“ aber noch eine Excel-Stückliste ein: Errors war 0, und View.GetBomTable lieferte sie danach. Für neue Stücklisten nimmst du trotzdem View.InsertBomTable6. Die Hilfe dieser Seite verweist dafür noch auf den veralteten Vorgänger View.InsertBomTable2.
Das Aussehen der Stückliste steuern Benutzereinstellungen, die du vor dem Aufruf setzt:
SldWorks.SetUserPreferenceTogglemitswBOMConfigurationLocked,swBOMConfigurationUseDocumentFont,swBOMConfigurationUseSummaryInfo,swBOMConfigurationAlignBottom,swBOMContentsDisplayAtTop,swBOMControlIdFromAssembly,swBOMControlMissingRowsundswBOMControlSplitTableSldWorks.SetUserPreferenceIntegerValuemitswBOMConfigurationAnchorType,swBOMConfigurationWhatToShow,swBOMControlMissingRowDisplayundswBOMControlSplitDirectionSldWorks.SetUserPreferenceDoubleValuemitswBOMControlSplitHeight
Für die Lage der Stückliste hilft View.GetXform (Lage der Ansicht auf dem Blatt) und View.GetOutline (Ausdehnung der Ansicht auf der Zeichnung).
Für Errors darfst du auch Nothing übergeben, wenn dich der Grund nicht interessiert. Da der Parameter in VBA ein ByRef Long ist, übergibst du hier einfach immer eine Long-Variable. Eine vorhandene Excel-Stückliste der Ansicht liefert View.GetBomTable.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2001Plus
Englisches Original: IView::InsertBomTable in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.