Methode · DrawingDoc
AutoBalloon5-Methode (DrawingDoc)
Fügt in den ausgewählten Zeichenansichten automatisch Positionsnummern für die Stückliste ein.
Syntax
Function AutoBalloon5( _
ByVal BalloonOptions As AutoBalloonOptions _
) As VariantvNummern = swDraw.AutoBalloon5(swOptionen)Parameter
BalloonOptionsAutoBalloonOptionsByValDie Einstellungen als
AutoBalloonOptions. Das Objekt erzeugst du mitDrawingDoc.CreateAutoBalloonOptionsund setzt danach seine Eigenschaften, zum Beispiel:AutoBalloonOptions.Layout: Anordnung um die Ansicht, Werte ausswBalloonLayoutType_e, etwaswDetailingBalloonLayout_Square(1) im Rechteck oderswDetailingBalloonLayout_Bottom(4) an der UnterkanteAutoBalloonOptions.Style: Form der Positionsnummer, Werte ausswBalloonStyle_e, etwaswBS_Circular(1) KreisAutoBalloonOptions.UpperTextContent: oberer Text der Positionsnummer, Werte ausswBalloonTextContent_e, etwaswBalloonTextItemNumber(1) Nummer der Stücklistenposition oderswBalloonTextQuantity(2) MengeAutoBalloonOptions.IgnoreMultiple:Truesetzt für eine Position, die mehrfach vorkommt, nur eine Positionsnummer,Falseeine für jedes Vorkommen
Bei Layout, Style, Size und UpperTextContent bedeutet
-1: die Vorgabe des Dokuments.
Rückgabewert
Array mit den eingefügten Positionsnummern als Note. Was zurückkommt, wenn nichts eingefügt wurde, sagt die Hilfe nicht. Prüf das Ergebnis deshalb mit IsArray.
Beispiel
' swModel ist die aktive Zeichnung mit Stückliste (ModelDoc2), swDraw dasselbe Dokument als DrawingDoc.
' swView ist eine Zeichenansicht (View) dieser Zeichnung.
Dim swOptionen As SldWorks.AutoBalloonOptions
Dim vNummern As Variant
Dim bErfolg As Boolean
Dim i As Long
bErfolg = swModel.Extension.SelectByID2(swView.GetName2, "DRAWINGVIEW", 0, 0, 0, False, 0, Nothing, swSelectOptionDefault)
Set swOptionen = swDraw.CreateAutoBalloonOptions
swOptionen.Layout = swDetailingBalloonLayout_Bottom
swOptionen.Style = swBS_Circular
swOptionen.UpperTextContent = swBalloonTextItemNumber
swOptionen.IgnoreMultiple = True
If bErfolg Then vNummern = swDraw.AutoBalloon5(swOptionen)
If IsArray(vNummern) Then
For i = 0 To UBound(vNummern)
Debug.Print "Positionsnummer " & vNummern(i).GetText
Next i
End IfBemerkungen
Ablauf:
- Eine oder mehrere Zeichenansichten oder Blätter auswählen.
- Mit
DrawingDoc.CreateAutoBalloonOptionseinAutoBalloonOptionserzeugen. - Dessen Eigenschaften setzen.
- AutoBalloon5 mit diesem Objekt aufrufen.
Ist ein Blatt ausgewählt, bekommen alle Zeichenansichten dieses Blatts Positionsnummern. Die Positionsnummern gehören zu den Positionen der Stückliste. Ob die Zeichnung dafür schon eine Stückliste haben muss, sagt die Befehlsseite nicht ausdrücklich. Eine einzelne Positionsnummer setzt ModelDocExtension.InsertBOMBalloon2.
Ersetzt DrawingDoc.AutoBalloon4, dem die Einstellungen noch als einzelne Parameter übergeben wurden.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2012
Englisches Original: IDrawingDoc::AutoBalloon5 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.