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.
Beschreibung
Mit BalloonOptions legst du fest, wie ModelDocExtension.InsertBOMBalloon2 eine einzelne Positionsnummer für die Stückliste einfügt. Der Ablauf:
- Das Element auswählen, das die Positionsnummer bekommt, etwa eine Kante in einer Zeichenansicht.
- Mit
ModelDocExtension.CreateBalloonOptionsein BalloonOptions erzeugen. - Seine Eigenschaften setzen.
- Das Objekt an
ModelDocExtension.InsertBOMBalloon2übergeben.
Seit SOLIDWORKS 2023 SP02 liest du die Einstellungen einer vorhandenen Positionsnummer mit Note.GetBalloonOptions.
Zugriff
ModelDocExtension.CreateBalloonOptions: ein neues Objekt mit EinstellungenNote.GetBalloonOptions: die Einstellungen einer vorhandenen Positionsnummer, seit SOLIDWORKS 2023 SP02
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| CustomSize | Liest oder setzt die eigene Größe der Positionsnummer. Sie gilt nur, wenn Size auf swBF_UserDef steht. |
| ItemNumberIncrement | Liest oder setzt die Schrittweite der Positionsnummern. |
| ItemNumberStart | Liest oder setzt die erste Positionsnummer. |
| ItemOrder | Liest oder setzt, wie die Positionen nummeriert werden: Nummern beibehalten, der Reihenfolge der Baugruppe folgen oder fortlaufend. |
| Layername | Liest oder setzt den Layer, auf dem die Positionsnummer entsteht. |
| LowerText | Liest oder setzt den unteren Text der Positionsnummer. Er gilt nur bei der Form geteilter Kreis. |
| LowerTextContent | Liest oder setzt, was im unteren Text der Positionsnummer steht, etwa die Menge. Er gilt nur bei der Form geteilter Kreis. |
| QuantityDenotationText | Liest oder setzt die Bezeichnung, die bei der Menge der Stücklistenposition steht. |
| QuantityOverride | Liest oder setzt, ob statt der Menge aus der Stückliste ein eigener Wert erscheint. |
| QuantityOverrideValue | Liest oder setzt die eigene Menge, die statt der Menge aus der Stückliste erscheint. Sie gilt nur, wenn QuantityOverride True ist. |
| QuantityPlacement | Liest oder setzt, wo die Menge der Stücklistenposition neben der Positionsnummer steht: links, rechts, oben oder unten. |
| ShowQuantity | Liest oder setzt, ob die Menge der Stücklistenposition neben der Positionsnummer erscheint. |
| Size | Liest oder setzt die Größe der Positionsnummer, etwa passend für zwei Zeichen oder benutzerdefiniert. |
| Style | Liest oder setzt die Form der Positionsnummer, etwa Kreis oder geteilter Kreis. |
| UpperText | Liest oder setzt den oberen Text der Positionsnummer. |
| UpperTextContent | Liest 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.