Customize Toolbars: Difference between revisions

From FreeCAD Documentation
m (minor)
(presentation)
Line 13: Line 13:


<!--T:5-->
<!--T:5-->
[[File:CustomizeToolBar 01.png]]
[[File:CustomizeToolBar 01.png|640px|center|Customize]]
{{clear}}
{{clear}}


Line 20: Line 20:


<!--T:7-->
<!--T:7-->
[[File:CustomizeToolBar 02.png]]
[[File:CustomizeToolBar 02.png|640px|center|Click the right mouse button]]
{{clear}}
{{clear}}


Line 27: Line 27:


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


Line 37: Line 37:


<!--T:12-->
<!--T:12-->
[[File:CustomizeToolBar 04.png]]
[[File:CustomizeToolBar 04.png|640px|center|Select an toolbar]]
{{clear}}
{{clear}}


<!--T:13-->
<!--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,


<div class="mw-collapsible mw-collapsed toccolours">

'''5''' : if your icon is not here then click the {{KEY|Add icons...}} button for adding one or more icons in your library (collapse to see)

<div class="mw-collapsible-content">


<!--T:14-->
<!--T:14-->
[[File:CustomizeToolBar 05.png]]
[[File:CustomizeToolBar 05.png|640px|center|Add icon]]
{{clear}}
{{clear}}


<!--T:15-->
<!--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
'''5b''' : 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-->
<!--T:16-->
[[File:CustomizeToolBar 06.png]]
[[File:CustomizeToolBar 06.png|640px|center|Get a file]]
{{clear}}
{{clear}}


</div>
</div>


<!--T:17-->
<!--T:17-->
Line 60: Line 67:


<!--T:18-->
<!--T:18-->
[[File:CustomizeToolBar 07.png]]
[[File:CustomizeToolBar 07.png|640px|center|Select your icon]]
{{clear}}
{{clear}}


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


<!--T:20-->
<!--T:20-->
[[File:CustomizeToolBar 08.png]]
[[File:CustomizeToolBar 08.png|640px|center|Your icon is displayed]]
{{clear}}
{{clear}}


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


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


<!--T:23-->
<!--T:23-->
[[File:CustomizeToolBar 09.png]]
[[File:CustomizeToolBar 09.png|640px|center|Click the button]]
{{clear}}
{{clear}}


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


<!--T:25-->
<!--T:25-->
[[File:CustomizeToolBar 10.png]]
[[File:CustomizeToolBar 10.png|640px|center|Your button is created]]
{{clear}}
{{clear}}


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


<!--T:27-->
<!--T:27-->
'''11''' : click the tab '''Toolbars'''
'''12''' : click the tab '''Toolbars''' and your workbench (here '''Part''')


<!--T:28-->
<!--T:28-->
[[File:CustomizeToolBar 11.png]]
[[File:CustomizeToolBar 11.png|640px|center|Tab Toolbabs]]
{{clear}}
{{clear}}


<!--T:29-->
<!--T:29-->
'''12''' : in left window select '''Macros'''
'''13''' : in left window select the Tab '''Macros''' and "Macros"


<!--T:30-->
<!--T:30-->
[[File:CustomizeToolBar 12.png]]
[[File:CustomizeToolBar 12.png|640px|center|Tab Macros > Macros]]
{{clear}}
{{clear}}


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


<!--T:32-->
<!--T:32-->
[[File:CustomizeToolBar 13.png]]
[[File:CustomizeToolBar 13.png|640px|center|Your icon appears]]
{{clear}}
{{clear}}


<!--T:33-->
<!--T:33-->
'''14''' : Click the button {{KEY|New...}} (you can choose your ToolBar here the ToolBar is attached to the Part Workbench)
'''15''' : Click the button {{KEY|New...}} (you can choose your ToolBar here the ToolBar is attached to the Part Workbench)


<!--T:34-->
<!--T:34-->
[[File:CustomizeToolBar 14.png]]
[[File:CustomizeToolBar 14.png|640px|center|Click the button New]]
{{clear}}
{{clear}}


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


<!--T:36-->
<!--T:36-->
[[File:CustomizeToolBar 15.png]]
[[File:CustomizeToolBar 15.png|640px|center|Enter the name for your Toolbar]]
{{clear}}
{{clear}}


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


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


<!--T:39-->
<!--T:39-->
[[File:CustomizeToolBar 16.png]]
[[File:CustomizeToolBar 16.png|640px|center|Select your macro]]
{{clear}}
{{clear}}


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


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


<!--T:42-->
<!--T:42-->
[[File:CustomizeToolBar 17.png]]
[[File:CustomizeToolBar 17.png|640px|center|Close]]
{{clear}}
{{clear}}


<!--T:43-->
<!--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
'''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]]
[[File:CustomizeToolBar 18.png|640px|center|New Toolbar]]
{{clear}}
{{clear}}


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





Revision as of 10:54, 2 January 2015

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


Customize
Customize

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

Click the right mouse button
Click the right mouse button

the window Customize appears

The window Customize appears
The window Customize appears

2 : select the tab Macro

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

Select an toolbar
Select an toolbar

4 : search for an icon amongst the icons already in FreeCAD,

5 : if your icon is not here then click the Add icons... button for adding one or more icons in your library (collapse to see)

Add icon
Add icon

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

Get a file
Get a file

6 : select your icon and click the OK button

Select your icon
Select your icon

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

Your icon is displayed
Your icon is displayed

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

9 : Click the button Add

Click the button
Click the button

10 : your button is created

Your button is created
Your button is created

11 : create a Toolbar for the button

12 : click the tab Toolbars and your workbench (here Part)

Tab Toolbabs
Tab Toolbabs

13 : in left window select the Tab Macros and "Macros"

Tab Macros > Macros
Tab Macros > Macros

14 : now your macro and it's icon appears

Your icon appears
Your icon appears

15 : Click the button New... (you can choose your ToolBar here the ToolBar is attached to the Part Workbench)

Click the button New
Click the button New

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

Enter the name for your Toolbar
Enter the name for your Toolbar

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

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

Select your macro
Select your macro

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

20 : click the Close button

Close
Close

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

New Toolbar
New Toolbar

22 : enjoy !