SolidWorksMakroprogrammierung

Objekt · SldWorks

StackedBalloonOptions-Objekt

Die Einstellungen für gestapelte Positionsnummern: Stapelrichtung, Positionsnummern je Zeile, Form, Größe, Text, Menge und Nummerierung.

Deklaration Dim x As SldWorks.StackedBalloonOptions · in der englischen .NET-Hilfe: IStackedBalloonOptions

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

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 Sub

Bemerkungen

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

NameBeschreibung
BalloonsPerLineLiest oder setzt, wie viele Positionsnummern in einer Zeile des Stapels stehen.
CustomSizeLiest oder setzt eine eigene Größe der Positionsnummern im Stapel.
ItemNumberIncrementLiest oder setzt die Schrittweite der Positionsnummern.
ItemNumberStartLiest oder setzt die erste Positionsnummer.
ItemOrderLiest oder setzt, wie die Positionsnummern geordnet werden.
LayernameLiest oder setzt den Namen des Layers, auf dem der Stapel entsteht.
LowerTextLiest oder setzt den unteren Text der Positionsnummern im Stapel.
LowerTextContentLiest oder setzt, was im unteren Teil der Positionsnummern im Stapel steht.
QuantityDenotationTextLiest oder setzt die Bezeichnung hinter der Menge, etwa „STK“.
QuantityOverrideLiest oder setzt, ob die Menge aus der Stückliste durch einen eigenen Wert ersetzt wird.
QuantityOverrideValueLiest oder setzt die eigene Menge, die statt der Menge aus der Stückliste erscheint.
QuantityPlacementLiest oder setzt, wo die Menge beim Stapel steht: oben oder unten.
ShowQuantityLiest oder setzt, ob die Menge der Stücklistenposition angezeigt wird.
SizeLiest oder setzt die Größe der Positionsnummern im Stapel.
StackDirectionLiest oder setzt, in welche Richtung die Positionsnummern gestapelt werden.
StyleLiest oder setzt die Form der Positionsnummern im Stapel, etwa Kreis oder geteilter Kreis.
UpperTextLiest oder setzt den oberen Text der Positionsnummern im Stapel.
UpperTextContentLiest 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.