Hide Table of Contents
AutoBalloon3 Method (IDrawingDoc)

Obsolete. Superseded by IDrawingDoc::AutoBalloon4.

.NET Syntax

Visual Basic (Declaration) 
Function AutoBalloon3( _
   ByVal Layout As System.Integer, _
   ByVal IgnoreMultiple As System.Boolean, _
   ByVal Style As System.Integer, _
   ByVal Size As System.Integer, _
   ByVal UpperTextContent As System.Integer, _
   ByVal UpperText As System.String, _
   ByVal LowerTextContent As System.Integer, _
   ByVal LowerText As System.String, _
   ByVal Layername As System.String _
) As System.Object
Visual Basic (Usage) 
Dim instance As IDrawingDoc
Dim Layout As System.Integer
Dim IgnoreMultiple As System.Boolean
Dim Style As System.Integer
Dim Size As System.Integer
Dim UpperTextContent As System.Integer
Dim UpperText As System.String
Dim LowerTextContent As System.Integer
Dim LowerText As System.String
Dim Layername As System.String
Dim value As System.Object
value = instance.AutoBalloon3(Layout, IgnoreMultiple, Style, Size, UpperTextContent, UpperText, LowerTextContent, LowerText, Layername)
System.object AutoBalloon3( 
   System.int Layout,
   System.bool IgnoreMultiple,
   System.int Style,
   System.int Size,
   System.int UpperTextContent,
   System.string UpperText,
   System.int LowerTextContent,
   System.string LowerText,
   System.string Layername
System.Object^ AutoBalloon3( 
&   System.int Layout,
&   System.bool IgnoreMultiple,
&   System.int Style,
&   System.int Size,
&   System.int UpperTextContent,
&   System.String^ UpperText,
&   System.int LowerTextContent,
&   System.String^ LowerText,
&   System.String^ Layername


Layout style of the balloons as defined by swBalloonLayoutType_e or specify -1 for this argument to use the document default layout style
True to apply a balloon to only one instance of a component, false to apply balloons to all instances of that component
Style of the balloons as defined by swBalloonStyle_e or specify -1 to use the document default balloon style
Fit of balloon as defined by swBalloonFit_e or specify -1 to use the document default balloon fit
Upper-text content style as defined by swBalloonTextContent_e or specify -1 to use the document default upper text content
Text for upper balloon

Lower-text content style as defined by swBalloonTextContent_e or specify -1 to use the document default lower text content

NOTE: This and the next argument are only effective when Style is set to swBS_SplitCirc. See the SOLIDWORKS Help for additional details about autoballoons.

Text for lower balloon
Name of the layer for this balloon

Return Value

Array of newly created notes



This method automatically creates the BOM balloons for the selected drawing views. If a drawing sheet is selected, BOM balloons are automatically created for all of the drawing views on that drawing sheet.

To get or set default values for...



IModelDocExtension::GetUserPreferenceInteger(swUserPreferenceIntegerValue_e.swDetailingAutoBalloonLayout, swUserPreferenceOption_e.swDetailingNoOptionSpecified) 
- or -
IModelDocExtension::SetUserPreferenceInteger(swUserPreferenceIntegerValue_e.swDetailingAutoBalloonLayout, swUserPreferenceOption_e.swDetailingNoOptionSpecified, swBalloonLayoutType_e.<Value>)


IModelDocExtension::GetUserPreferenceInteger((swUserPreferenceIntegerValue_e.swDetailingBOMBalloonStyle, swUserPreferenceOption_e.swDetailingNoOptionSpecified)
- or -
IModelDocExtension::SetUserPreferenceInteger(swUserPreferenceIntegerValue_e.swDetailingBOMBalloonFit, swUserPreferenceOption_e.swDetailingNoOptionSpecified, swBalloonFit_e.<Value>)


IModelDocExtension::GetUserPreferenceInteger((swUserPreferenceIntegerValue_e.swDetailingBOMBalloonFit, swUserPreferenceOption_e.swDetailingNoOptionSpecified)
- or -
(swUserPreferenceIntegerValue_e.swDetailingBOMStackedBalloonFit, swUserPreferenceOption_e.swDetailingNoOptionSpecified, swBalloonFit_e.<Value>)


IModelDocExtension::GetUserPreferenceInteger(swUserPreferenceIntegerValue_e.swDetailingBOMUpperText, swUserPreferenceOption_e.swDetailingNoOptionSpecified)
-  or -
IModelDocExtension::SetUserPreferenceInteger(swUserPreferenceIntegerValue_e.swDetailingBOMUpperText, swUserPreferenceOption_e.swDetailingNoOptionSpecified, swBalloonTextContent_e.<Value>)


IModelDocExtension::GetUserPreferenceInteger(swUserPreferenceIntegerValue_e.swDetailingBOMLowerText, swUserPreferenceOption_e.swDetailingNoOptionSpecified)
- or -
IModelDocExtension::SetUserPreferenceInteger(swUserPreferenceIntegerValue_e.swDetailingBOMLowerText, swUserPreferenceOption_e.swDetailingNoOptionSpecified, swBalloonTextContent_e.<Value>)

This method also allows you to get only the balloons just created.


See Also


SOLIDWORKS 2007 FCS, Revision Number 15.0

Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

Subject:   Feedback on Help Topics
Page:   AutoBalloon3 Method (IDrawingDoc)
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:


We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again

Web Help Content Version: API Help (English only) 2017 SP05

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.