Customize Toolbars: Difference between revisions

From FreeCAD Documentation
(Finition de la page)
(Marked this version for translation)
(29 intermediate revisions by 9 users not shown)
Line 1: Line 1:
<languages/>
{{TutorialInfo|Class=SampleClass|Level=Beginner|Time=5 minutes|Author=[[User:Mario52|Mario52]]|FCVersion=Alls}}
<translate>
<!--T:1-->
{{TutorialInfo|Topic=SampleTopic|Level=Beginner|Time=5 minutes|Author=[[User:Mario52|Mario52]]|FCVersion=All}}


===Synopsis===
==Synopsis== <!--T:54-->


<!--T:2-->
This tutorial walks you through how to create a Toolbar button and one or more that connect you to your favorite macros or other links assiciant there a custom icon or not.
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== <!--T:55-->
===Uses===


<!--T:3-->
'''1''' : Click to '''Menu > Tools > Customize'''
<u>'''1.''' Find the Customize Menu</u>


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


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


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


<!--T:7-->
[[File:CustomizeToolBar 02.png]]
[[File:CustomizeToolBar 02.png|640px|center|Right mouse click]]
{{clear}}
{{clear}}


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


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


<!--T:52-->
'''2''' : select the menu Macro
<u>'''2.''' Make a Macro to a Macro-Tool</u>


<!--T:10-->
'''3''' : to Pixmap click button {{KEY|... }}
*Select the "Macro" tab.


<!--T:11-->
[[File:CustomizeToolBar 04.png]]
*To add an icon for the provided macro click the Pixmap button (labelled {{KEY|... }}).

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


<!--T:13-->
'''4''' : search your icon if your icon is not here click to {{KEY|Add icons...}}
*Search for an appropriate icon from amongst FreeCAD's existing icons,

<!--T:47-->
<div class="mw-collapsible mw-collapsed toccolours">

<!--T:48-->
&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-->
<div class="mw-collapsible-content">


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


<!--T:15-->
'''5''' : if you icon is not here click to {{KEY|Add icons...}} for adding one or more icons in your library
&nbsp; &nbsp; &nbsp;[You will get a file selection window, select your custom image file (PNG format, 64x64 pixels)]


<!--T:16-->
[[File:CustomizeToolBar 06.png]]
[[File:CustomizeToolBar 06.png|640px|center|Get a file]]
{{clear}}
{{clear}}


<!--T:50-->
</div>
</div>


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


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


<!--T:19-->
your icon are selected and displayed next to the button {{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|640px|center|Your icon is displayed]]
{{clear}}
{{clear}}


<!--T:21-->
'''7''' : Choice your macro and specify one Menu text and other informations 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-->
'''8''' : Click the button {{KEY|Add}}
* Click the button {{KEY|Add}}.


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


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


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


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


<!--T:27-->
'''11''' : Click the menu '''Toolbars'''
* 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-->
[[File:CustomizeToolBar 11.png]]
&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-->
[[File:CustomizeToolBar 11.png|640px|center|Toolbars tab]]
{{clear}}
{{clear}}


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


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


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


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


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


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


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


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


<!--T:37-->
'''16''' : your ToolBar is created and appear checked
*The toolbar is now created.


<!--T:38-->
'''17''' : select your button of the left window and click the {{KEY|Button}} arrow 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-->
[[File:CustomizeToolBar 16.png]]
[[File:CustomizeToolBar 16.png|640px|center|Select your macro]]
{{clear}}
{{clear}}


<!--T:40-->
'''18''' : your button is associated of the Toolbar Camera
* You have created now a toolbar called "Camera" (with the Macro-tool '''Camera''' in it)


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


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


<!--T:43-->
'''20''' : your ToolBar is here whit your 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).


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


==Notes== <!--T:53-->
'''21''' : enjoy !


<!--T:56-->
See also [[Interface_Customization|Interface Customization]].


</translate>

[[Category:Tutorials]]
[[Category:Preferences{{#translation:}}]]
{{clear}}

Revision as of 06:21, 3 May 2020

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.

Usage

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

Notes

See also Interface Customization.