SolidWorksMakroprogrammierung

Objekt · SldWorks

BalloonOptions-Objekt

Die Einstellungen einer Stücklisten-Positionsnummer: Form, Größe, Text, Menge und Nummerierung. Du übergibst sie an InsertBOMBalloon2 oder liest sie an einer vorhandenen Positionsnummer.

Deklaration Dim x As SldWorks.BalloonOptions · in der englischen .NET-Hilfe: IBalloonOptions

Beschreibung

Mit BalloonOptions legst du fest, wie ModelDocExtension.InsertBOMBalloon2 eine einzelne Positionsnummer für die Stückliste einfügt. Der Ablauf:

  1. Das Element auswählen, das die Positionsnummer bekommt, etwa eine Kante in einer Zeichenansicht.
  2. Mit ModelDocExtension.CreateBalloonOptions ein BalloonOptions erzeugen.
  3. Seine Eigenschaften setzen.
  4. Das Objekt an ModelDocExtension.InsertBOMBalloon2 übergeben.

Seit SOLIDWORKS 2023 SP02 liest du die Einstellungen einer vorhandenen Positionsnummer mit Note.GetBalloonOptions.

Zugriff

Beispiel

' Setzt an die ausgewählte Kante eine Positionsnummer im Kreis mit der Menge rechts daneben.
' Vorbedingung: Eine Zeichnung mit Stückliste ist offen,
'               eine Kante einer Komponente in einer Zeichenansicht ist ausgewählt.
' Ergebnis:     Die Positionsnummer steht an der Kante, ihr Text im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swOpt As SldWorks.BalloonOptions
    Dim swNote As SldWorks.Note

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocDRAWING Then Exit Sub
    If swModel.SelectionManager.GetSelectedObjectCount2(-1) = 0 Then Exit Sub

    Set swOpt = swModel.Extension.CreateBalloonOptions
    swOpt.Style = swBS_Circular
    swOpt.Size = swBF_2Chars
    swOpt.UpperTextContent = swBalloonTextItemNumber
    swOpt.ShowQuantity = True
    swOpt.QuantityPlacement = swBalloonQuantityPlacement_Right
    swOpt.QuantityDenotationText = "X"                  ' Bezeichnung zur Menge
    swOpt.QuantityOverride = False                      ' Menge aus der Stückliste

    Set swNote = swModel.Extension.InsertBOMBalloon2(swOpt)
    If swNote Is Nothing Then
        Debug.Print "Keine Positionsnummer eingefügt."
    Else
        Debug.Print "Positionsnummer: " & swNote.GetText
    End If
End Sub

Bemerkungen

Vorgabe des Dokuments: Bei Style, Size, UpperTextContent und LowerTextContent heißt -1: die Vorgabe des Dokuments. Die Vorgaben stehen in den Dokumenteigenschaften swDetailingBOMBalloonStyle, swDetailingBOMBalloonFit, swDetailingBOMUpperText und swDetailingBOMLowerText (swUserPreferenceIntegerValue_e).

Abhängigkeiten: Einige Eigenschaften gelten nur zusammen mit einer anderen:

  • CustomSize nur bei Size = swBF_UserDef
  • LowerText und LowerTextContent nur bei Style = swBS_SplitCirc
  • QuantityOverrideValue nur bei QuantityOverride = True

Gelesene Einstellungen: Liest du die Einstellungen mit Note.GetBalloonOptions, gelten ItemNumberStart, ItemNumberIncrement und ItemOrder nicht, ItemNumberStart steht dann auf -1. Die Nummerierung steht dann an der verknüpften Stückliste (BomFeature), deren Namen View.GetKeepLinkedToBOMName liefert. Layername ist in Teilen und Baugruppen leer, in Zeichnungen ebenso, wenn die Positionsnummer auf keinem Layer liegt.

Andere Positionsnummern: Für automatische Positionsnummern einer ganzen Ansicht gibt es AutoBalloonOptions, für gestapelte ModelDocExtension.CreateStackedBalloonOptions.

Getestet: Das Beispiel lief in SOLIDWORKS 2024 an einer Zeichnung einer Baugruppe aus zwei Quadern und einem Würfel mit Stückliste. Mit einer ausgewählten Kante des Würfels setzte es die Positionsnummer 2 mit „1X“ rechts daneben.

Ein neues Objekt hatte diese Werte: Style 1, Size 2, CustomSize 0,01016, UpperTextContent 1, LowerTextContent 2, ShowQuantity False, QuantityPlacement 1, QuantityDenotationText „X“, QuantityOverride False, ItemNumberStart 1, ItemNumberIncrement 1, ItemOrder 1, UpperText, LowerText, QuantityOverrideValue und Layername leer.

Eigenschaften und Methoden

Eigenschaften 16, davon 16 beschrieben

NameBeschreibung
CustomSizeLiest oder setzt die eigene Größe der Positionsnummer. Sie gilt nur, wenn Size auf swBF_UserDef steht.
ItemNumberIncrementLiest oder setzt die Schrittweite der Positionsnummern.
ItemNumberStartLiest oder setzt die erste Positionsnummer.
ItemOrderLiest oder setzt, wie die Positionen nummeriert werden: Nummern beibehalten, der Reihenfolge der Baugruppe folgen oder fortlaufend.
LayernameLiest oder setzt den Layer, auf dem die Positionsnummer entsteht.
LowerTextLiest oder setzt den unteren Text der Positionsnummer. Er gilt nur bei der Form geteilter Kreis.
LowerTextContentLiest oder setzt, was im unteren Text der Positionsnummer steht, etwa die Menge. Er gilt nur bei der Form geteilter Kreis.
QuantityDenotationTextLiest oder setzt die Bezeichnung, die bei der Menge der Stücklistenposition steht.
QuantityOverrideLiest oder setzt, ob statt der Menge aus der Stückliste ein eigener Wert erscheint.
QuantityOverrideValueLiest oder setzt die eigene Menge, die statt der Menge aus der Stückliste erscheint. Sie gilt nur, wenn QuantityOverride True ist.
QuantityPlacementLiest oder setzt, wo die Menge der Stücklistenposition neben der Positionsnummer steht: links, rechts, oben oder unten.
ShowQuantityLiest oder setzt, ob die Menge der Stücklistenposition neben der Positionsnummer erscheint.
SizeLiest oder setzt die Größe der Positionsnummer, etwa passend für zwei Zeichen oder benutzerdefiniert.
StyleLiest oder setzt die Form der Positionsnummer, etwa Kreis oder geteilter Kreis.
UpperTextLiest oder setzt den oberen Text der Positionsnummer.
UpperTextContentLiest oder setzt, was im oberen Text der Positionsnummer steht, etwa die Positionsnummer oder die Menge.

Siehe auch

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

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