SolidWorksMakroprogrammierung

Methode · DrawingDoc

CreateAutoBalloonOptions-Methode (DrawingDoc)

Erzeugt ein Objekt mit den Einstellungen für automatische Positionsnummern, das du danach an AutoBalloon5 übergibst.

Syntax

Function CreateAutoBalloonOptions() As AutoBalloonOptions
Set swOptionen = swDraw.CreateAutoBalloonOptions

Rückgabewert

Ein neues AutoBalloonOptions-Objekt.

Beispiel

' swModel ist die aktive Zeichnung mit Stückliste (ModelDoc2), swDraw dasselbe Dokument als DrawingDoc.
Dim swSheet As SldWorks.Sheet
Dim swOptionen As SldWorks.AutoBalloonOptions
Dim vNummern As Variant
Set swSheet = swDraw.GetCurrentSheet
If swModel.Extension.SelectByID2(swSheet.GetName, "SHEET", 0, 0, 0, False, 0, Nothing, swSelectOptionDefault) Then
    Set swOptionen = swDraw.CreateAutoBalloonOptions
    swOptionen.Layout = swDetailingBalloonLayout_Square
    swOptionen.Style = -1                 ' Vorgabe des Dokuments
    swOptionen.Size = -1                  ' Vorgabe des Dokuments
    swOptionen.UpperTextContent = swBalloonTextItemNumber
    swOptionen.IgnoreMultiple = True
    vNummern = swDraw.AutoBalloon5(swOptionen)
    If IsArray(vNummern) Then Debug.Print UBound(vNummern) + 1 & " Positionsnummern auf " & swSheet.GetName
End If

Bemerkungen

Ablauf:

  1. Eine oder mehrere Zeichenansichten oder Blätter auswählen.
  2. Mit CreateAutoBalloonOptions ein AutoBalloonOptions erzeugen.
  3. Dessen Eigenschaften setzen, etwa Layout (Anordnung, swBalloonLayoutType_e), Style (Form, swBalloonStyle_e) oder UpperTextContent (Text, swBalloonTextContent_e).
  4. Das Objekt an DrawingDoc.AutoBalloon5 übergeben.

Bei Layout, Style, Size und UpperTextContent heißt -1: die Vorgabe des Dokuments. Welche Werte ein neu erzeugtes Objekt hat, sagt die Hilfe nicht. Setz deshalb alle Eigenschaften, auf die es dir ankommt. Der Blattname im Beispiel kommt aus Sheet.GetName, damit es in deutschen und englischen Zeichnungen gleich funktioniert.

Für einzelne Positionsnummern gibt es eigene Einstellungsobjekte: ModelDocExtension.CreateBalloonOptions und ModelDocExtension.CreateStackedBalloonOptions.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2012

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

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