Objekt · SldWorks
StackedBalloonOptions-Objekt
Die Einstellungen für gestapelte Positionsnummern: Stapelrichtung, Positionsnummern je Zeile, Form, Größe, Text, Menge und Nummerierung.
Beschreibung
StackedBalloonOptions gibt Zugriff auf die Einstellungen für gestapelte Positionsnummern. Ein Stapel fasst mehrere Positionsnummern der Stückliste an einem Hinweispfeil zusammen. Du legst fest, in welche Richtung gestapelt wird, wie viele Positionsnummern in einer Zeile stehen und wie jede Positionsnummer aussieht. Die Befehle gibt es seit SOLIDWORKS 2012.
Zugriff
ModelDocExtension.CreateStackedBalloonOptions: ein neues Objekt fürModelDocExtension.InsertStackedBalloon2
Beispiel
' Fügt am ausgewählten Element einen Stapel aus runden Positionsnummern ein, die nach
' rechts gestapelt werden, mit Menge darüber.
' Vorbedingung: Eine Baugruppe oder Zeichnung mit Stückliste ist offen, ein Element
' (etwa eine Fläche) für die erste Positionsnummer ist ausgewählt.
' Ergebnis: Ein Stapel mit einer Positionsnummer. Weitere fügst du an, indem du
' anschließend weitere Elemente auswählst.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swOpt As SldWorks.StackedBalloonOptions
Dim swNote As SldWorks.Note
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.SelectionManager.GetSelectedObjectCount2(-1) < 1 Then Exit Sub
Set swOpt = swModel.Extension.CreateStackedBalloonOptions
swOpt.StackDirection = swStackedBalloonDir_Right
swOpt.BalloonsPerLine = 10
swOpt.Style = swBS_Circular
swOpt.Size = swBF_5Chars
swOpt.UpperTextContent = swBalloonTextItemNumber
swOpt.ShowQuantity = True
swOpt.QuantityPlacement = swBalloonQuantityPlacement_Top
swOpt.QuantityDenotationText = "STK"
swOpt.ItemOrder = swBalloonItemNumbers_DoNotChangeItemNumbers
Set swNote = swModel.Extension.InsertStackedBalloon2(swOpt)
If swNote Is Nothing Then
Debug.Print "Kein Stapel eingefügt"
ElseIf swNote.IsStackedBalloon Then
Debug.Print "Gestapelte Positionsnummern: " & swNote.GetName
End If
End SubBemerkungen
Ablauf: Du wählst ein Element für die erste Positionsnummer aus, erzeugst mit ModelDocExtension.CreateStackedBalloonOptions das Objekt, setzt seine Eigenschaften und übergibst es an ModelDocExtension.InsertStackedBalloon2. Danach wählst du ein oder mehrere Elemente aus, die zum Stapel hinzukommen. Das Hilfebeispiel „Insert BOM Table and Stacked Balloon“ wählt dazu nach dem Einfügen weitere Flächen mit ModelDocExtension.SelectByID2 aus.
Vorgaben des Dokuments: Bei StackedBalloonOptions.Style, StackedBalloonOptions.Size, StackedBalloonOptions.UpperTextContent und StackedBalloonOptions.LowerTextContent steht -1 für die Vorgabe des Dokuments. Diese Vorgaben liest und setzt du mit ModelDocExtension.GetUserPreferenceInteger und ModelDocExtension.SetUserPreferenceInteger.
Einzelne Positionsnummern: Für eine einzelne Positionsnummer gibt es das ähnliche BalloonOptions. Für weitere Einzelheiten verweist die Hilfe auf die SOLIDWORKS-Hilfe zu gestapelten Positionsnummern.
Eigenschaften und Methoden
Eigenschaften 18, davon 18 beschrieben
| Name | Beschreibung |
|---|---|
| BalloonsPerLine | Liest oder setzt, wie viele Positionsnummern in einer Zeile des Stapels stehen. |
| CustomSize | Liest oder setzt eine eigene Größe der Positionsnummern im Stapel. |
| ItemNumberIncrement | Liest oder setzt die Schrittweite der Positionsnummern. |
| ItemNumberStart | Liest oder setzt die erste Positionsnummer. |
| ItemOrder | Liest oder setzt, wie die Positionsnummern geordnet werden. |
| Layername | Liest oder setzt den Namen des Layers, auf dem der Stapel entsteht. |
| LowerText | Liest oder setzt den unteren Text der Positionsnummern im Stapel. |
| LowerTextContent | Liest oder setzt, was im unteren Teil der Positionsnummern im Stapel steht. |
| QuantityDenotationText | Liest oder setzt die Bezeichnung hinter der Menge, etwa „STK“. |
| QuantityOverride | Liest oder setzt, ob die Menge aus der Stückliste durch einen eigenen Wert ersetzt wird. |
| QuantityOverrideValue | Liest oder setzt die eigene Menge, die statt der Menge aus der Stückliste erscheint. |
| QuantityPlacement | Liest oder setzt, wo die Menge beim Stapel steht: oben oder unten. |
| ShowQuantity | Liest oder setzt, ob die Menge der Stücklistenposition angezeigt wird. |
| Size | Liest oder setzt die Größe der Positionsnummern im Stapel. |
| StackDirection | Liest oder setzt, in welche Richtung die Positionsnummern gestapelt werden. |
| Style | Liest oder setzt die Form der Positionsnummern im Stapel, etwa Kreis oder geteilter Kreis. |
| UpperText | Liest oder setzt den oberen Text der Positionsnummern im Stapel. |
| UpperTextContent | Liest oder setzt, was im oberen Teil der Positionsnummern im Stapel steht, etwa die Positionsnummer. |
Siehe auch
Englisches Original: IStackedBalloonOptions in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.