This Generation Task will Auto Balloon a Drawing View.
Multi-Sheet Drawings
This Tasks requires requires the specified View Name to be on the currently active sheet.
If the Drawing this Task is run on has more than one sheet use the Activate Sheet Task immediately before running this Task.
| Property Name | Description |
|---|---|
| Edit Balloon Options | True (default) to replace existing balloons, False to re-sequence. |
| Edit Balloons | TRUE to use Edit Balloon Options when creating the Auto Balloons. |
| Ignore Multiple | TRUE (default) to create a Balloon for only one Instance of an Item, FALSE for multiple. |
| Insert Magnetic Line | TRUE (default) to insert magnetic lines with Balloons. |
| Item Number Increment | Sets the Item Number increment. |
| Item Number Start | Sets the starting number. |
| Item Order | Sets the Item ordering.
SOLIDWORKS could add further enumerators that affect the Item order.
For a complete, current list of all enumerators please go to: SOLIDWORKS Web Help, Select API Help and search for swBalloonItemNumbersOrder_e Enumeration. |
| Layer Name | Sets the name of the Layer on which to create Balloons (must be a valid Layer name). |
| Layout | Sets the style of the layout of the Balloons.
SOLIDWORKS could add further enumerators that affect Layout options.
For a complete, current list of all enumerators please go to: SOLIDWORKS Web Help, Select API Help and search for swBalloonLayoutType_e Enumeration. |
| Leader Attached To Faces | TRUE to attach Balloons to Faces (default is FALSE). |
| Reverse Direction | TRUE to reverse the Item ordering (default is FALSE). |
| Size | Sets the size of the Balloons (0 to 5).
|
| Style | Sets the style of the Balloons.
Please note the most common Balloon style enumerators are listed. For a complete, current list of all enumerators please go to: SOLIDWORKS Web Help, Select API Help and search for swBalloonStyle_e Enumeration. |
| Upper Text | Sets the Upper Text of the Balloon. |
| Upper Text Content | Sets the style of the Upper Text Content.
Please note an enumerator value is required for the Balloon text content. For a complete, current list of all enumerators please go to: SOLIDWORKS Web Help, Select API Help and search for swBalloonTextContent_e Enumeration. |
| (Name) | The unique name for this task. |
| View Name | The name of the View to Auto Balloon. |
When this task is added the properties are both static. To be able to build rules on a static properties see How To: Change A Static Property To A Dynamic Property.
| Property Name | Example Rule | Example Result | Meaning |
|---|---|---|---|
| Edit Balloon Options | TRUE | TRUE | TRUE will replace any existing Balloons. FALSE would resquence any existing Balloons. |
| Edit Balloons | TRUE | TRUE | TRUE will use the Edit Balloon Options Property result when creating the Auto Balloons either Replacing or Resquencing existing Balloons. |
| Ignore Multiple | TRUE | TRUE | TRUE will create a Balloon for only one Instance of an item. |
| Insert Magnetic Line | TRUE | TRUE | TRUE will insert Magnetic Lines when the inserting the Balloons. |
| Item Number Increment | "1" | 1 | This will increment the values in the Balloons by 1. |
| Item Number Start | "1" | 1 | This is the number that the Balloon values will start at. |
| Item Order | "2" | 2 | This will put the Balloons into Assembly order. This means that the first Part that was added to an Assembly would be the first Balloon value. In this example that would be 1. |
| Layer Name | "BalloonLayer" | BalloonLayer | This is the lLayer that the Balloons will be created on. This must be a valid Layer name. If no Layers have been created, leaving it blank will create the Balloons on the default FORMAT Layer. |
| Layout | "3" | 3 | This will align the Balloons to the top of the Drawing. See the tables above for different alignment types. |
| Leader Attached To Faces | TRUE | TRUE | TRUE will attached the Leader Lines from the Balloon to the Faces of the Part. |
| Reverse Direction | FALSE | FALSE | FALSE will keep the ordering the same. TRUE would reverse this. |
| Size | "2" | 2 | This will use the two character size for the Balloons. |
| Style | "3" | 3 | This will use hexagon Balloons when Auto Ballooning. |
| Upper Text | "SW-Long Date" | SW-Long Date | This is what to use for the Upper Text. In this example this is a name of a Custom Property. |
| Upper Text Content | CustomProperties | CustomProperties | When using Balloons with both Upper and Lower sections such as a SplitCircle Balloon this will set the Upper property to be a Custom Property. When using a dynamic rule "3". |
| View Name | "Drawing View1" | Drawing View1 | The Name of the Drawing View that you want to Auto Balloon. |
When this task is added the properties are both static. To be able to build rules on a static properties see How To: Change A Static Property To A Dynamic Property.
| Property Name | Example Rule | Example Result | Meaning |
|---|---|---|---|
| Edit Balloon Options | TRUE | TRUE | TRUE will replace any existing Balloons. FALSE would resquence any existing Balloons. |
| Edit Balloons | TRUE | TRUE | TRUE will use the Edit Balloon Options Property result when creating the Auto Balloons either Replacing or Resquencing existing Balloons. |
| Ignore Multiple | TRUE | TRUE | TRUE will create a Balloon for only one Instance of an item. |
| Insert Magnetic Line | TRUE | TRUE | TRUE will insert Magnetic Lines when the inserting the Balloons. |
| Item Number Increment | "1" | 1 | This will increment the values in the Balloons by 1. |
| Item Number Start | "1" | 1 | This is the number that the Balloon values will start at. |
| Item Order | "2" | 2 | This will put the Balloons into Assembly order. This means that the first Part that was added to an Assembly would be the first Balloon value. In this example that would be 1. |
| Layer Name | "BalloonLayer" | BalloonLayer | This is the lLayer that the Balloons will be created on. This must be a valid Layer name. If no Layers have been created, leaving it blank will create the Balloons on the default FORMAT Layer. |
| Layout | "3" | 3 | This will align the Balloons to the top of the Drawing. See the tables above for different alignment types. |
| Leader Attached To Faces | TRUE | TRUE | TRUE will attached the Leader Lines from the Balloon to the Faces of the Part. |
| Reverse Direction | FALSE | FALSE | FALSE will keep the ordering the same. TRUE would reverse this. |
| Size | "2" | 2 | This will use the two character size for the Balloons. |
| Style | "3" | 3 | This will use hexagon Balloons when Auto Ballooning. |
| Upper Text | "SW-Long Date" | SW-Long Date | This is what to use for the Upper Text. In this example this is a name of a Custom Property. |
| Upper Text Content | CustomProperties | CustomProperties | When using Balloons with both Upper and Lower sections such as a SplitCircle Balloon this will set the Upper property to be a Custom Property. When using a dynamic rule "3". |
| View Name | "Drawing View1" | Drawing View1 | The Name of the Drawing View that you want to Auto Balloon. |
This Task can be added to the following Generation Sequence(s):
DriveWorks Tech Tips Portal |
Drawing Control Generation Tasks Use the Auto Arrange Dimensions, Auto Balloon View and Rescale and Position View generation tasks to control a driven drawing. |
DriveWorks Tech Tips Portal is available to DriveWorks Pro customers with an active subscription and support contract. Tech Tips provide cut down projects that highlight specific functionality for faster and more effective learning. To access the portal:
The portal provides a search facility, start typing the name of the Tech Tip (as indicated above) to display the Tip you require. |