Customize Toolbars: Difference between revisions

From FreeCAD Documentation
(sachlich klarer, welche Rolle Makros spielen)
(Gliederung geändert)
Line 7: Line 7:


==Use== <!--T:3-->
==Use== <!--T:3-->
<u>'''1.''' Find the Customize Menu</u>


<!--T:4-->
<!--T:4-->
'''1''' : Click {{MenuCommand|Menu → Tools → Customize}}
*Click {{MenuCommand|Main Menu → Tools → Customize}},



<!--T:5-->
<!--T:5-->
Line 17: Line 17:


<!--T:6-->
<!--T:6-->
or right click on any toolbar
*or right click on any toolbar.


<!--T:7-->
<!--T:7-->
Line 24: Line 24:


<!--T:8-->
<!--T:8-->
the Customize window appears
*The Customize window appears.


<!--T:9-->
<!--T:9-->
[[File:CustomizeToolBar 03.png|640px|center|The Customize window appears]]
[[File:CustomizeToolBar 03.png|640px|center|The Customize window appears]]
{{clear}}
{{clear}}

<u>'''2.''' Make a Macro to a Macro-Tool</u>


<!--T:10-->
<!--T:10-->
'''2''' : select the "Macro" tab
*Select the "Macro" tab.


<!--T:11-->
<!--T:11-->
'''3''' : to add a toolbar icon for your macro click the Pixmap button (labelled {{KEY|... }})
*To add an icon for the provided macro click the Pixmap button (labelled {{KEY|... }}).


<!--T:12-->
<!--T:12-->
Line 41: Line 43:


<!--T:13-->
<!--T:13-->
'''4''' : search for an appropriate icon from amongst FreeCAD's existing icons,
*Search for an appropriate icon from amongst FreeCAD's existing icons,


<!--T:47-->
<!--T:47-->
Line 47: Line 49:


<!--T:48-->
<!--T:48-->
'''5''' : or add your own icon by clicking {{KEY|Add icons...}} (expand for an example)
&nbsp; &nbsp; &nbsp; [or add your own icon by clicking {{KEY|Add icons...}}]. &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;(expand for an example)


<!--T:49-->
<!--T:49-->
Line 57: Line 59:


<!--T:15-->
<!--T:15-->
'''5b''' : you will get a file selection window, select your custom image file (PNG format, 64x64 pixels)
&nbsp; &nbsp; &nbsp;[You will get a file selection window, select your custom image file (PNG format, 64x64 pixels)]


<!--T:16-->
<!--T:16-->
Line 68: Line 70:


<!--T:17-->
<!--T:17-->
'''6''' : select your icon and click {{KEY|OK}}
* Select your icon and click {{KEY|OK}}.


<!--T:18-->
<!--T:18-->
Line 75: Line 77:


<!--T:19-->
<!--T:19-->
'''7''' : the icon you selected is now displayed next to the Pixmap button labelled {{KEY|...}}
* The icon you selected is now displayed next to the Pixmap button labelled {{KEY|...}}.


<!--T:20-->
<!--T:20-->
Line 82: Line 84:


<!--T:21-->
<!--T:21-->
'''8''' : Choose your 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); there are other optional fields for your Button
*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.


<!--T:22-->
<!--T:22-->
'''9''' : Click the button {{KEY|Add}}
* Click the button {{KEY|Add}}.


<!--T:23-->
<!--T:23-->
Line 92: Line 94:


<!--T:24-->
<!--T:24-->
'''10''' : your button has now been created
*The button of the macro-tool is now created.


<!--T:25-->
<!--T:25-->
Line 99: Line 101:


<!--T:26-->
<!--T:26-->
'''11''' : create a toolbar for the button
<u>'''3.''' Create a toolbar outside the workbench '''Macro''' which contains the created '''Macro-tool'''</u>


<!--T:27-->
<!--T:27-->
'''12''' : go to the '''Toolbars''' tab and choose your workbench in the drop down on the right ('''Part''' in this example)
* 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).


<!--T:51-->
<!--T:51-->
Since version 0.15 there is a {{KEY|[[File:Freecad.svg|16px]] Global }} toolbar. If your toolbar is docked in this bar, it will always remain visible
&nbsp; &nbsp; &nbsp;[Since version 0.15 there is a &nbsp;{{KEY|[[File:Freecad.svg|16px]] Global}}&nbsp; toolbar. If this is selected, the provided toolbar will be in each workbench.]


<!--T:28-->
<!--T:28-->
Line 112: Line 114:


<!--T:29-->
<!--T:29-->
'''13''' : in the dropdown on the left select '''Macros'''
*In the dropdown on the left select '''Macros'''.


<!--T:30-->
<!--T:30-->
Line 119: Line 121:


<!--T:31-->
<!--T:31-->
'''14''' : your macro and its icon appears in the list
*The macro-tool with its icon appears in the list.


<!--T:32-->
<!--T:32-->
Line 126: Line 128:


<!--T:33-->
<!--T:33-->
'''15''' : Click the button {{KEY|New...}} (you can choose your toolbar here and it will be attached to the Part Workbench)
*Click the button {{KEY|New...}}


<!--T:34-->
<!--T:34-->
Line 133: Line 135:


<!--T:35-->
<!--T:35-->
'''16''' : in the window "New Toolbar" enter the name for your toolbar and click {{KEY|OK}}
*In the window "New Toolbar" enter the name of the provided extra toolbar for the '''Part''' Workbench and click {{KEY|OK}}


<!--T:36-->
<!--T:36-->
Line 140: Line 142:


<!--T:37-->
<!--T:37-->
*The toolbar is now created.
'''17''' : your toolbar has now been created - make sure you check its checkbox so that it will actually appear


<!--T:38-->
<!--T:38-->
'''18''' : To add your customized macro to the new toolbar, select it in the left window and then click the {{KEY|Button}} with the arrow pointing right
*To add the creadet macro-tool to this toolbar, select it in the left window and then click the {{KEY|Button}} with the arrow pointing right.


<!--T:39-->
<!--T:39-->
Line 150: Line 152:


<!--T:40-->
<!--T:40-->
'''19''' : you have now created a toolbar called "Camera"
* You have created now a toolbar called "Camera" (with the Macro-tool '''Camera''' in it)


<!--T:41-->
<!--T:41-->
'''20''' : click the {{KEY|Close}} button
*Click the {{KEY|Close}} button.


<!--T:42-->
<!--T:42-->
Line 160: Line 162:


<!--T:43-->
<!--T:43-->
*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).
'''21''' : your new toolbar with its button is now displayed above the active window as well as in the toolbars' right-click menu


<!--T:44-->
<!--T:44-->
[[File:CustomizeToolBar 18.png|640px|center|New Toolbar]]
[[File:CustomizeToolBar 18.png|640px|center|New Toolbar]]
{{clear}}
{{clear}}

<!--T:45-->
'''22''' : enjoy !






Revision as of 19:34, 20 February 2017

Tutorial
Topic
SampleTopic
Level
Beginner
Time to complete
5 minutes
Authors
Mario52
FreeCAD version
All
Example files
None
See also
None

Synopsis

This tutorial shows you the customization of toolbars. Tools can used in different workbenches. Macro-tools are includet (a Macro becames a Macro-tool by creation of a Menu text, a Tool tip and an Icon).

Use

1. Find the Customize Menu

  • Click Main Menu → Tools → Customize,
Customize
Customize
  • or right click on any toolbar.
Right mouse click
Right mouse click
  • The Customize window appears.
The Customize window appears
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 ... ).
Select a toolbar
Select a toolbar
  • Search for an appropriate icon from amongst FreeCAD's existing icons,

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

Add icon
Add icon

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

Get a file
Get a file
  • Select your icon and click OK.
Select your icon
Select your icon
  • The icon you selected is now displayed next to the Pixmap button labelled ....
Your icon is displayed
Your icon is displayed
  • 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 Add.
Click the button
Click the button
  • The button of the macro-tool is now created.
Your button is created
Your button is 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   Global  toolbar. If this is selected, the provided toolbar will be in each workbench.]

Toolbars tab
Toolbars tab
  • In the dropdown on the left select Macros.
Macros
Macros
  • The macro-tool with its icon appears in the list.
Your icon is listed
Your icon is listed
  • Click the button New...
Click on "New"
Click on "New"
  • In the window "New Toolbar" enter the name of the provided extra toolbar for the Part Workbench and click OK
Enter the name for your toolbar
Enter the name for your toolbar
  • The toolbar is now created.
  • To add the creadet macro-tool to this toolbar, select it in the left window and then click the Button with the arrow pointing right.
Select your macro
Select your macro
  • You have created now a toolbar called "Camera" (with the Macro-tool Camera in it)
  • Click the Close button.
Close
Close
  • 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).
New Toolbar
New Toolbar


Other languages:
Retrieved from "http://wiki.freecad.org/index.php?title=Customize_Toolbars&oldid=222536"