Objekt · SldWorks
BalloonStack-Objekt
Eine gestapelte Positionsnummer (Ballonstapel): die Positionsnummern im Stapel lesen, weitere hinzufügen, Richtung und Reihenlänge ändern.
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
Note.GetBalloonStack: der Stapel, zu dem eine Positionsnummer gehört
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Count | Liefert die Zahl der Positionsnummern im Stapel, ohne die Haupt-Positionsnummer. |
| Direction | Liest oder setzt, in welche Richtung die Positionsnummern gestapelt sind: oben, unten, links oder rechts. |
| Length | Liest oder setzt, wie viele Positionsnummern in einer Reihe des Stapels stehen, bevor eine neue Reihe beginnt. |
| Master | Liefert die Haupt-Positionsnummer des Stapels. |
| Stack | Liefert die Positionsnummern des Stapels ohne die Haupt-Positionsnummer. |
Methoden 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| AddTo | Fü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.