SolidWorksMakroprogrammierung

Objekt · SldWorks

BalloonStack-Objekt

Eine gestapelte Positionsnummer (Ballonstapel): die Positionsnummern im Stapel lesen, weitere hinzufügen, Richtung und Reihenlänge ändern.

Deklaration Dim x As SldWorks.BalloonStack · in der englischen .NET-Hilfe: IBalloonStack

Beschreibung

BalloonStack gibt Zugriff auf die Eigenschaften eines Stapels von Positionsnummern, etwa seine Richtung. Jede Positionsnummer im Stapel ist eine eigene Notiz (Note). Den Text und andere Eigenschaften einer einzelnen Positionsnummer liest und setzt du dort.

Zugriff

Beispiel

' Gibt die Positionsnummern des Stapels aus, zu dem die ausgewählte Positionsnummer gehört,
' und stapelt sie danach nach unten mit höchstens drei je Reihe.
' Vorbedingung: Eine Zeichnung ist offen, eine gestapelte Positionsnummer ist ausgewählt.
' Ergebnis:     Die Texte stehen im Direktfenster, der Stapel ist umgestellt.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swNote As SldWorks.Note
    Dim swStapel As SldWorks.BalloonStack
    Dim swPos As SldWorks.Note
    Dim vStapel As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelNOTES Then Exit Sub
    Set swNote = swSelMgr.GetSelectedObject6(1, -1)
    If False = swNote.IsStackedBalloon Then Exit Sub

    Set swStapel = swNote.GetBalloonStack
    Debug.Print "Haupt-Positionsnummer: " & swStapel.Master.GetText
    vStapel = swStapel.Stack
    If IsArray(vStapel) Then
        For i = 0 To UBound(vStapel)
            Set swPos = vStapel(i)
            Debug.Print "  " & swPos.GetText
        Next i
    End If
    Debug.Print swStapel.Count & " weitere Positionsnummern im Stapel"

    swStapel.Direction = swStackedBalloonDir_Down
    swStapel.Length = 3                                      ' höchstens 3 je Reihe
    swModel.EditRebuild3                                     ' erst danach zeigt die Zeichnung die neue Anordnung
End Sub

Bemerkungen

Neuaufbau: Nach dem Setzen von BalloonStack.Direction oder BalloonStack.Length liefern die Eigenschaften gleich die neuen Werte. Die Zeichnung zeigt die neue Anordnung erst nach einem Neuaufbau, etwa mit ModelDoc2.EditRebuild3.

Haupt-Positionsnummer: BalloonStack.Count und BalloonStack.Stack lassen sie weg. Du bekommst sie mit BalloonStack.Master. Ob eine Notiz die Haupt-Positionsnummer ist, liefert Note.IsStackedBalloonMaster.

Anlegen: Eine gestapelte Positionsnummer fügst du mit ModelDocExtension.InsertStackedBalloon2 ein, die Einstellungen dafür erzeugst du mit ModelDocExtension.CreateStackedBalloonOptions. Seit SOLIDWORKS 2019 machst du mit Note.MakeStackedBalloon aus einer vorhandenen Positionsnummer einen Stapel.

Auch in Modellen: Das Hilfebeispiel „Add Balloon to Stacked Balloon“ legt die gestapelte Positionsnummer in einer Baugruppe an, nicht in einer Zeichnung.

Getestet: Das Beispiel lief in SOLIDWORKS 2024 an einer Zeichnung einer Baugruppe aus zwei Quadern und einem Würfel mit Stückliste. Der Stapel entstand mit ModelDocExtension.InsertStackedBalloon2 am Würfel, mit BalloonStack.AddTo kamen beide Quader dazu. Mit ausgewählter Haupt-Positionsnummer gab das Beispiel 50, 55 und 55 aus, dazu „2 weitere Positionsnummern im Stapel“, und stellte den Stapel nach unten um. Ohne den Neuaufbau am Ende blieb die Anordnung in der Zeichnung zunächst die alte.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
CountLiefert die Zahl der Positionsnummern im Stapel, ohne die Haupt-Positionsnummer.
DirectionLiest oder setzt, in welche Richtung die Positionsnummern gestapelt sind: oben, unten, links oder rechts.
LengthLiest oder setzt, wie viele Positionsnummern in einer Reihe des Stapels stehen, bevor eine neue Reihe beginnt.
MasterLiefert die Haupt-Positionsnummer des Stapels.
StackLiefert die Positionsnummern des Stapels ohne die Haupt-Positionsnummer.

Methoden 1, davon 1 beschrieben

NameBeschreibung
AddToFügt dem Stapel eine Positionsnummer für das vorher ausgewählte Element hinzu.

Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IGetStack). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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