Customize Toolbars

Synopsis
This tutorial shows you the customization of toolbars. Tools (inclusive Macro-tools) can used in different workbenches. In an example a Macro becomes a Macro-tool by creation of a Menu text, a Tool tip and an Icon. Afterwards this Macro-tool becomes part of an extra toolbar in a workbench.

Usage
1. Find the Customize Menu


 * Click ,




 * or right click on any toolbar.




 * The Customize window appears.



2. Make a Macro to a Macro-Tool


 * Select the "Macro" tab.


 * To add an icon for  the provided macro click the Pixmap button (labelled ).




 * Search for an appropriate icon from amongst FreeCAD's existing icons,

[or add your own icon by clicking ]. (expand for an example)



[You will get a file selection window, select your custom image file (PNG format, 64x64 pixels)]




 * Select your icon and click.




 * The icon you selected is now displayed next to the Pixmap button labelled.




 * Select the provided macro in line Macro: and specify a Menu text: (which will appear as the text label in the menu); also fill in the 'Tool Tip': (which is the text that will appear when a mouse is over the button on the toolbar); further lines are optional.


 * Click the button.




 * The button of the macro-tool is now created.



3. Create a toolbar outside the workbench Macro which contains the created Macro-tool


 * Select the Toolbars tab and choose the workbench (for which the toolbar is provided) in the drop down on the right (Part in this example).

[Since version 0.15 there is a   toolbar. If this is selected, the provided toolbar will be in each workbench.]




 * In the dropdown on the left select Macros.




 * The macro-tool with its icon appears in the list.




 * Click the button




 * In the window "New Toolbar" enter the name of the provided extra toolbar for the Part Workbench and click




 * The toolbar is now created.


 * To add the creadet macro-tool to this toolbar, select it in the left window and then click the with the arrow pointing right.




 * You have created now a toolbar called "Camera" (with the Macro-tool Camera in it)


 * Click the button.




 * Your new toolbar is now contained in the toolbars' right-click menu. Its Icons (in our example only the camera) are visible, if the toolbar is activated (blue checkmark).



Notes for Python based functions like those in Draft
If you want to use a Draft or other Python based function in a toolbar they don't seem to be available in the drop down list at the left side. You first have to load the corresponding workbench, e.g. Draft, and then you will find the functions available when selecting "Python" in the left drop down menu.