SolidWorksMakroprogrammierung

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 Object
Set 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 Datei bomtemp.xls aus 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ückgabe

SOLIDWORKS schreibt das Ergebnis als Wert aus swBOMConfigurationCreationErrors_e hinein:

  • swBOMTableCreation_Okay (0): Stückliste erstellt
  • swBOMTableCreation_UnspecifiedError (-1): Fehler aus unbekanntem Grund
  • swBOMTableCreation_MustBeDrawingView (-2): geht nur bei einer Zeichenansicht
  • swBOMTableCreation_AlreadyExists (-3): die Ansicht hat schon eine Stückliste
  • swBOMTableCreation_ExcelDisabled (-4): Excel ist auf diesem Rechner deaktiviert
  • swBOMTableCreation_Failed (-5): die Vorlage ist ungültig
  • swBOMTableCreation_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 If

Bemerkungen

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:

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.