Customize Toolbars: Difference between revisions

From FreeCAD Documentation
(translate)
(Marked this version for translation)
Line 1: Line 1:
<translate>
<translate>
<!--T:1-->
{{TutorialInfo|Class=SampleClass|Level=Beginner|Time=5 minutes|Author=[[User:Mario52|Mario52]]|FCVersion=All}}
{{TutorialInfo|Class=SampleClass|Level=Beginner|Time=5 minutes|Author=[[User:Mario52|Mario52]]|FCVersion=All}}


===Synopsis===
===Synopsis=== <!--T:2-->
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 a custom icon or not.
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 a custom icon or not.


===Use===
===Use=== <!--T:3-->


<!--T:4-->
'''1''' : Click '''Menu → Tools → Customize'''
'''1''' : Click '''Menu → Tools → Customize'''




<!--T:5-->
[[File:CustomizeToolBar 01.png]]
[[File:CustomizeToolBar 01.png]]
{{clear}}
{{clear}}


<!--T:6-->
or put you on a Toolbar and click the right mouse button
or put you on a Toolbar and click the right mouse button


<!--T:7-->
[[File:CustomizeToolBar 02.png]]
[[File:CustomizeToolBar 02.png]]
{{clear}}
{{clear}}


<!--T:8-->
the window Customize appears
the window Customize appears


<!--T:9-->
[[File:CustomizeToolBar 03.png]]
[[File:CustomizeToolBar 03.png]]
{{clear}}
{{clear}}


<!--T:10-->
'''2''' : select the tab Macro
'''2''' : select the tab Macro


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


<!--T:12-->
[[File:CustomizeToolBar 04.png]]
[[File:CustomizeToolBar 04.png]]
{{clear}}
{{clear}}


<!--T:13-->
'''4''' : search for an icon amongst the icons already in FreeCAD, if your icon is not here then click the {{KEY|Add icons...}} button for adding one or more icons in your library
'''4''' : search for an icon amongst the icons already in FreeCAD, if your icon is not here then click the {{KEY|Add icons...}} button for adding one or more icons in your library




<!--T:14-->
[[File:CustomizeToolBar 05.png]]
[[File:CustomizeToolBar 05.png]]
{{clear}}
{{clear}}


<!--T:15-->
'''5''' : you will get a file selection window, select your image file which must be in the PNG format and must be 64x64 pixels
'''5''' : you will get a file selection window, select your image file which must be in the PNG format and must be 64x64 pixels


<!--T:16-->
[[File:CustomizeToolBar 06.png]]
[[File:CustomizeToolBar 06.png]]
{{clear}}
{{clear}}




<!--T:17-->
'''6''' : select your icon and click the {{KEY|OK}} button
'''6''' : select your icon and click the {{KEY|OK}} button


<!--T:18-->
[[File:CustomizeToolBar 07.png]]
[[File:CustomizeToolBar 07.png]]
{{clear}}
{{clear}}


<!--T:19-->
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-->
[[File:CustomizeToolBar 08.png]]
[[File:CustomizeToolBar 08.png]]
{{clear}}
{{clear}}


<!--T:21-->
'''7''' : 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
'''7''' : 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


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


<!--T:23-->
[[File:CustomizeToolBar 09.png]]
[[File:CustomizeToolBar 09.png]]
{{clear}}
{{clear}}


<!--T:24-->
'''9''' : your button is created
'''9''' : your button is created


<!--T:25-->
[[File:CustomizeToolBar 10.png]]
[[File:CustomizeToolBar 10.png]]
{{clear}}
{{clear}}


<!--T:26-->
'''10''' : create a Toolbar for the button
'''10''' : create a Toolbar for the button


<!--T:27-->
'''11''' : click the tab '''Toolbars'''
'''11''' : click the tab '''Toolbars'''


<!--T:28-->
[[File:CustomizeToolBar 11.png]]
[[File:CustomizeToolBar 11.png]]
{{clear}}
{{clear}}


<!--T:29-->
'''12''' : in left window select '''Macros'''
'''12''' : in left window select '''Macros'''


<!--T:30-->
[[File:CustomizeToolBar 12.png]]
[[File:CustomizeToolBar 12.png]]
{{clear}}
{{clear}}


<!--T:31-->
'''13''' : now your macro and it's icon appears
'''13''' : now your macro and it's icon appears


<!--T:32-->
[[File:CustomizeToolBar 13.png]]
[[File:CustomizeToolBar 13.png]]
{{clear}}
{{clear}}


<!--T:33-->
'''14''' : Click the button {{KEY|New...}}
'''14''' : Click the button {{KEY|New...}}


<!--T:34-->
[[File:CustomizeToolBar 14.png]]
[[File:CustomizeToolBar 14.png]]
{{clear}}
{{clear}}


<!--T:35-->
'''15''' : in the window "New Toolbar" enter the name for your ToolBar and click {{KEY|OK}}
'''15''' : in the window "New Toolbar" enter the name for your ToolBar and click {{KEY|OK}}


<!--T:36-->
[[File:CustomizeToolBar 15.png]]
[[File:CustomizeToolBar 15.png]]
{{clear}}
{{clear}}


<!--T:37-->
'''16''' : your ToolBar has now been created - make sure you check the checkbox so the toolbar will actually appear
'''16''' : your ToolBar has now been created - make sure you check the checkbox so the toolbar will actually appear


<!--T:38-->
'''17''' : select your macro with it's icon in the left window and then click the {{KEY|Button}} with the right pointing arrow
'''17''' : select your macro with it's icon in the left window and then click the {{KEY|Button}} with the right pointing arrow


<!--T:39-->
[[File:CustomizeToolBar 16.png]]
[[File:CustomizeToolBar 16.png]]
{{clear}}
{{clear}}


<!--T:40-->
'''18''' : you have now created a toolbar called "Camera"
'''18''' : you have now created a toolbar called "Camera"


<!--T:41-->
'''19''' : click the {{KEY|Close}} button
'''19''' : click the {{KEY|Close}} button


<!--T:42-->
[[File:CustomizeToolBar 17.png]]
[[File:CustomizeToolBar 17.png]]
{{clear}}
{{clear}}


<!--T:43-->
'''20''' : 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
'''20''' : 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-->
[[File:CustomizeToolBar 18.png]]
[[File:CustomizeToolBar 18.png]]
{{clear}}
{{clear}}


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






<!--T:46-->
[[Category:Tutorials]]
[[Category:Tutorials]]
</translate>
</translate>

Revision as of 17:23, 15 December 2014

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

Synopsis

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 a custom icon or not.

Use

1 : Click Menu → Tools → Customize


or put you on a Toolbar and click the right mouse button

the window Customize appears

2 : select the tab Macro

3 : to select an toolbar icon for your macro click the Pixmap button (labelled ... )

4 : search for an icon amongst the icons already in FreeCAD, if your icon is not here then click the Add icons... button for adding one or more icons in your library


5 : you will get a file selection window, select your image file which must be in the PNG format and must be 64x64 pixels


6 : select your icon and click the OK button

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

7 : 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

8 : Click the button Add

9 : your button is created

10 : create a Toolbar for the button

11 : click the tab Toolbars

12 : in left window select Macros

13 : now your macro and it's icon appears

14 : Click the button New...

15 : in the window "New Toolbar" enter the name for your ToolBar and click OK

16 : your ToolBar has now been created - make sure you check the checkbox so the toolbar will actually appear

17 : select your macro with it's icon in the left window and then click the Button with the right pointing arrow

18 : you have now created a toolbar called "Camera"

19 : click the Close button

20 : 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

21 : enjoy !