Customize Toolbars: Difference between revisions
mNo edit summary |
Renatorivo (talk | contribs) No edit summary |
||
(7 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
⚫ | |||
<translate> |
<translate> |
||
<!--T:1--> |
<!--T:1--> |
||
Line 4: | Line 5: | ||
==Synopsis== <!--T:2--> |
==Synopsis== <!--T:2--> |
||
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. |
|||
This tutorial walks you through how to create a Toolbar button and one or more buttons that connect you to your favourite macros or to other associated links whether there is a custom icon or not. |
|||
==Use== <!--T:3--> |
==Use== <!--T:3--> |
||
<u>'''1.''' Find the Customize Menu</u> |
|||
<!--T:4--> |
<!--T:4--> |
||
*Click {{MenuCommand|Main Menu → Tools → Customize}}, |
|||
<!--T:5--> |
<!--T:5--> |
||
Line 17: | Line 18: | ||
<!--T:6--> |
<!--T:6--> |
||
*or right click on any toolbar. |
|||
or put you on a Toolbar and click the right mouse button |
|||
<!--T:7--> |
<!--T:7--> |
||
[[File:CustomizeToolBar 02.png|640px|center| |
[[File:CustomizeToolBar 02.png|640px|center|Right mouse click]] |
||
{{clear}} |
{{clear}} |
||
<!--T:8--> |
<!--T:8--> |
||
*The Customize window appears. |
|||
<!--T:9--> |
<!--T:9--> |
||
[[File:CustomizeToolBar 03.png|640px|center|The |
[[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--> |
||
*Select the "Macro" tab. |
|||
'''2''' : select the tab Macro |
|||
<!--T:11--> |
<!--T:11--> |
||
*To add an icon for the provided macro click the Pixmap button (labelled {{KEY|... }}). |
|||
<!--T:12--> |
<!--T:12--> |
||
[[File:CustomizeToolBar 04.png|640px|center|Select |
[[File:CustomizeToolBar 04.png|640px|center|Select a toolbar]] |
||
{{clear}} |
{{clear}} |
||
<!--T:13--> |
<!--T:13--> |
||
*Search for an appropriate icon from amongst FreeCAD's existing icons, |
|||
<!--T:47--> |
<!--T:47--> |
||
Line 47: | Line 51: | ||
<!--T:48--> |
<!--T:48--> |
||
[or add your own icon by clicking {{KEY|Add icons...}}]. (expand for an example) |
|||
<!--T:49--> |
<!--T:49--> |
||
Line 57: | Line 61: | ||
<!--T:15--> |
<!--T:15--> |
||
[You will get a file selection window, select your custom image file (PNG format, 64x64 pixels)] |
|||
<!--T:16--> |
<!--T:16--> |
||
Line 68: | Line 72: | ||
<!--T:17--> |
<!--T:17--> |
||
* Select your icon and click {{KEY|OK}}. |
|||
<!--T:18--> |
<!--T:18--> |
||
Line 75: | Line 79: | ||
<!--T:19--> |
<!--T:19--> |
||
* The icon you selected is now displayed next to the Pixmap button labelled {{KEY|...}}. |
|||
<!--T:20--> |
<!--T:20--> |
||
Line 82: | Line 86: | ||
<!--T:21--> |
<!--T:21--> |
||
''' |
*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--> |
||
* Click the button {{KEY|Add}}. |
|||
<!--T:23--> |
<!--T:23--> |
||
Line 92: | Line 96: | ||
<!--T:24--> |
<!--T:24--> |
||
*The button of the macro-tool is now created. |
|||
<!--T:25--> |
<!--T:25--> |
||
Line 99: | Line 103: | ||
<!--T:26--> |
<!--T:26--> |
||
<u>'''3.''' Create a toolbar outside the workbench '''Macro''' which contains the created '''Macro-tool'''</u> |
|||
'''11''' : create a Toolbar for the button |
|||
<!--T:27--> |
<!--T:27--> |
||
* 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 |
[Since version 0.15 there is a {{KEY|[[File:Freecad.svg|16px]] Global}} toolbar. If this is selected, the provided toolbar will be in each workbench.] |
||
<!--T:28--> |
<!--T:28--> |
||
[[File:CustomizeToolBar 11.png|640px|center| |
[[File:CustomizeToolBar 11.png|640px|center|Toolbars tab]] |
||
{{clear}} |
{{clear}} |
||
<!--T:29--> |
<!--T:29--> |
||
*In the dropdown on the left select '''Macros'''. |
|||
<!--T:30--> |
<!--T:30--> |
||
[[File:CustomizeToolBar 12.png|640px|center| |
[[File:CustomizeToolBar 12.png|640px|center|Macros]] |
||
{{clear}} |
{{clear}} |
||
<!--T:31--> |
<!--T:31--> |
||
*The macro-tool with its icon appears in the list. |
|||
<!--T:32--> |
<!--T:32--> |
||
[[File:CustomizeToolBar 13.png|640px|center|Your icon |
[[File:CustomizeToolBar 13.png|640px|center|Your icon is listed]] |
||
{{clear}} |
{{clear}} |
||
<!--T:33--> |
<!--T:33--> |
||
*Click the button {{KEY|New...}} |
|||
<!--T:34--> |
<!--T:34--> |
||
[[File:CustomizeToolBar 14.png|640px|center|Click |
[[File:CustomizeToolBar 14.png|640px|center|Click on "New"]] |
||
{{clear}} |
{{clear}} |
||
<!--T:35--> |
<!--T:35--> |
||
*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--> |
||
[[File:CustomizeToolBar 15.png|640px|center|Enter the name for your |
[[File:CustomizeToolBar 15.png|640px|center|Enter the name for your toolbar]] |
||
{{clear}} |
{{clear}} |
||
<!--T:37--> |
<!--T:37--> |
||
*The toolbar is now created. |
|||
'''17''' : your ToolBar has now been created - make sure you check the checkbox so the toolbar will actually appear |
|||
<!--T:38--> |
<!--T:38--> |
||
*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 154: | ||
<!--T:40--> |
<!--T:40--> |
||
* You have created now a toolbar called "Camera" (with the Macro-tool '''Camera''' in it) |
|||
<!--T:41--> |
<!--T:41--> |
||
*Click the {{KEY|Close}} button. |
|||
<!--T:42--> |
<!--T:42--> |
||
Line 160: | Line 164: | ||
<!--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 it's button is now both displayed above the active window as well as the right-click menu from the toolbars |
|||
<!--T:44--> |
<!--T:44--> |
||
[[File:CustomizeToolBar 18.png|640px|center|New Toolbar]] |
[[File:CustomizeToolBar 18.png|640px|center|New Toolbar]] |
||
{{clear}} |
{{clear}} |
||
⚫ | |||
'''22''' : enjoy ! |
|||
</translate> |
</translate> |
||
{{clear}} |
{{clear}} |
||
⚫ |
Revision as of 20:17, 2 August 2018
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 (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.
Use
1. Find the Customize Menu
- Click Main Menu → Tools → Customize,
- 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 Add icons...]. (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 OK.
- 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 Add.
- 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 Global 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 New...
- In the window "New Toolbar" enter the name of the provided extra toolbar for the Part Workbench and click OK
- 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.
- You have created now a toolbar called "Camera" (with the Macro-tool Camera in it)
- Click the Close 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).