TechDraw Balloon

From FreeCAD Documentation
Revision as of 21:06, 15 October 2019 by Mario52 (talk | contribs) ((Vertical Docnav))
Jump to navigation Jump to search

This documentation is not finished. Please help and contribute documentation.

Gui Command explains how tools should be documented. See Draft ShapeString for an example of a well documented tool. Browse Category:UnfinishedDocu to see incomplete pages like this one. See Category:Command Reference for all commands.

See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.

Other languages:
Deutsch • ‎English • ‎français • ‎italiano • ‎русский

TechDraw Balloon.svg TechDraw Balloon

Menu location
TechDraw → Balloon
Default shortcut
Introduced in version
See also
TechDraw New annotation


The Balloon tool can add balloons with leader line in a drawing.

Techdraw balloon.png

How to use

  1. Select the View to which the Balloon will be attached.
  2. Press the TechDraw Balloon.svg Balloon button.
  3. The cursor is now displayed as a balloon icon. Click on the page to place the balloon origin to the desired position.
  4. The balloon bubble may be dragged to the desired position. Use CTRL-drag to move the bubble and the arrow.
  5. You can change balloon properties by double clicking balloon label or balloon object in the tree. This will open the Balloon Task dialog:
Task balloon.png

Using separators

When using a rectangle shape, separators can be added using "|" in the text. For example "AAA|TEST|111" gives:

Balloon separator.png



  • DataX: Horizontal position of the balloon bubble relative to the View.
  • DataY: Vertical position of the balloon bubble relative to the View.


  • ViewFont: The name of the font to use for the balloon bubble.
  • ViewFontsize: Dimension text size in mm.


See also: TechDraw API and FreeCAD Scripting Basics.

The Balloon tool can be used in macros and from the Python console by using the following functions:

bal1 = FreeCAD.ActiveDocument.addObject('TechDraw::DrawViewBalloon','Balloon')
rc = page.addView(bal1)