ONYX - Utilisation - Personnalisation de l'interface Designer/en

Différence entre versions

De MappingDoc
(Page créée avec « ==Example 2 : How to hide the "Home" tab== »)
 
(32 révisions intermédiaires par 3 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
 
<languages/>
 
<languages/>
 
Onyx Designer 10.1 (Official release due end of June 2020) and behond gives the possibility to custom its interface bu hiding the button of the ruban bar.
 
 
 
  
  
Ligne 13 : Ligne 9 :
 
*Executing the '''initGlobalStyle.reg''' file included in the setup
 
*Executing the '''initGlobalStyle.reg''' file included in the setup
  
<div class="mw-translate-fuzzy">
 
 
==Limits==
 
==Limits==
This first version gives only the possibility to play with the buttons of the Ruban bar located at the top the screen. Other possibilities will come next.
+
This first version gives only the possibility to modify the buttons of the Ruban bar located at the top the screen. Other possibilities will come next.
</div>
 
  
 
==How to hide  ribbon tool bar elements==
 
==How to hide  ribbon tool bar elements==
Ligne 25 : Ligne 19 :
  
  
The '''global''' Style is to hide the categories, panels and buttons based on the '''global.xml''' file. This file must be located in the '''Styles''' folder of the Designer installation folder.
+
The '''global''' Style is to hide the categories, panels and buttons based on the '''global.xml''' file. This file must be located in the '''Styles''' subfolder of the Designer installation folder.
  
  
Ligne 31 : Ligne 25 :
  
 
In order to customize the ribbon, we must first execute the '''initGlobalStyle.reg'''.  It will add a registery key with the xml file containing the elements to hide. (by default : global.xml)
 
In order to customize the ribbon, we must first execute the '''initGlobalStyle.reg'''.  It will add a registery key with the xml file containing the elements to hide. (by default : global.xml)
 +
 +
Windows Registry Editor Version 5.00
 +
[HKEY_CURRENT_USER\SOFTWARE\Mapping\M-Designer\Settings]
 +
"GlobalStyle"="global.xml"
 +
 +
 +
If the station is used by several different users, each can have its own style file. To do so, duplicate the global.xml file in order to obtain one file per user, for example: nicolas.xml, jerome.xml.
 +
 +
Then, adapt the initGlobalStyle.reg file for each user in order to modify their respective registry key according to the style to be applied.
 +
 +
 +
''Exemple :''
 +
 +
'''Nicolas :'''
 +
Windows Registry Editor Version 5.00
 +
[HKEY_CURRENT_USER\SOFTWARE\Mapping\M-Designer\Settings]
 +
"GlobalStyle"="nicolas.xml"
 +
 +
 +
 +
'''Jérôme : '''
 +
Windows Registry Editor Version 5.00
 +
[HKEY_CURRENT_USER\SOFTWARE\Mapping\M-Designer\Settings]
 +
"GlobalStyle"="jerome.xml"
  
 
===Setting up the XML file===
 
===Setting up the XML file===
  
The XML file contains the same nodes as the former style file with the <style> node. We added the <ui> node containing a list of <menu> nodes. This node corresponds to the categories, panels and buttons to be display or hidden.
+
The XML file contains the same nodes as the former style file with the <style> node.
  
  <?xml version="1.0" encoding="utf-8"?>
+
We add a '' '<ui>' '' node which will contain a list of '' '<menu>' '' nodes. These will correspond to the categories, panels and buttons to display or delete:
 +
 
 +
   
 +
<?xml version="1.0" encoding="utf-8"?>
 
  <style>
 
  <style>
 
         <ui>
 
         <ui>
               <menu ... />
+
               <menu category="xxxxx" panel="xxxxx" id="xxxxx" status="on|off" />
 
               <menu ... />
 
               <menu ... />
 
                   ...
 
                   ...
Ligne 52 : Ligne 73 :
 
*'''status''': value indicating whether we display the element ('''“on”''') or not ('''“off”''')
 
*'''status''': value indicating whether we display the element ('''“on”''') or not ('''“off”''')
 
<br>
 
<br>
<u<Note</U> : If we want to hide a button, we will have to specify all four attributes of the menu node. However, if we want to hide a category, we will need only to specify the attribute category and status. Same if we want to hide the pannel, we will then only need to specify the attribute category, panel et status. Note that the status must always be specified.
 
  
In the following example, the '''generate project''' button, the '''Insert''' pannel and the '''format''' category will not be displayed in the Designer interface.
+
In the following example, the '''generate project''' button, the '''Insert''' panel and the '''format''' category will not be displayed in the Designer interface.
  
 
<?xml version="1.0" encoding="utf-8"?>
 
<?xml version="1.0" encoding="utf-8"?>
Ligne 69 : Ligne 89 :
 
===List of names===
 
===List of names===
  
The pannels and buttons located in multiple categories must be specified in the '''home''' category and will be hidden in all categories.
+
The panels and buttons located in multiple categories must be specified in the '''home''' category and will be hidden in all categories.
  
 
====Categories====
 
====Categories====
Ligne 80 : Ligne 100 :
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
! Categorie !! Attribut XML
+
! Categorie !! @category
 
|-
 
|-
 
| Edit || format
 
| Edit || format
Ligne 93 : Ligne 113 :
 
|}
 
|}
  
 +
Example :
 +
<menu category="format" status="on"/>
 +
<menu category="view" status="off"/>
  
====Pannels====
+
====Panels====
  
The pannels represent in the interface the '''button blocs'''.
+
The panels represent in the interface the '''button blocs'''.
  
 
[[File:OX_D_CUSTOM7.jpg|1000px|center|sans_cadre]]  
 
[[File:OX_D_CUSTOM7.jpg|1000px|center|sans_cadre]]  
Ligne 103 : Ligne 126 :
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
! Panneaux !! Attribut XML
+
! Panneaux !! @panel
 
|-
 
|-
 
| Clipboard || clipboard
 
| Clipboard || clipboard
Ligne 131 : Ligne 154 :
 
| Window|| window
 
| Window|| window
 
|}
 
|}
 +
 +
Example :
 +
<menu category="shape" panel="insert" status="on"/>
 +
<menu category="shape" panel="form" status="off"/>
  
 
====Buttons====
 
====Buttons====
Ligne 137 : Ligne 164 :
  
 
[[File:OX_D_CUSTOM8.jpg|1000px|center|sans_cadre]]  
 
[[File:OX_D_CUSTOM8.jpg|1000px|center|sans_cadre]]  
 +
 +
 +
[[File:OX_D_CUSTOM2.jpg|1000px|right|sans_cadre]]
 +
[[File:OX_D_CUSTOM3.jpg|1000px|right|sans_cadre]]
 +
[[File:OX_D_CUSTOM4.jpg|1000px|right|sans_cadre]]
 +
[[File:OX_D_CUSTOM5.jpg|1000px|right|sans_cadre]]
 +
  
  
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
! Buttons !! XML Attributes
+
! Buttons !! @id
 
|-
 
|-
 
| Paste|| paste
 
| Paste|| paste
Ligne 151 : Ligne 185 :
 
| Copy Formatting || copy_format
 
| Copy Formatting || copy_format
 
|-
 
|-
| Duplicate || '''dupplicate'''
+
| Duplicate || duplicate
 
|-
 
|-
 
| font group || font_group
 
| font group || font_group
Ligne 258 : Ligne 292 :
 
|}
 
|}
  
[[File:OX_D_CUSTOM2.jpg|1000px|center|sans_cadre]]
+
Example :  
[[File:OX_D_CUSTOM3.jpg|1000px|center|sans_cadre]]
+
<menu category="home" panel="preview" id="preview_btn" status="on"/>
[[File:OX_D_CUSTOM4.jpg|1000px|center|sans_cadre]]
+
<menu category="home" panel="preview" id="open_spool" status="off"/>
[[File:OX_D_CUSTOM5.jpg|1000px|center|sans_cadre]]
+
 
 +
<br clear=all>
  
 
==Example 1 : How to hide the "Generate Project" button==
 
==Example 1 : How to hide the "Generate Project" button==
Ligne 271 : Ligne 306 :
 
==Example 2 : How to hide the "Home" tab==
 
==Example 2 : How to hide the "Home" tab==
  
Afin de cacher l'onglet "Home", il faut passer la ligne suivante du '''global.xml''' à la valeur OFF :
+
In order to hide the '''Home''' tab, we need to change the status to '''off''' in the global.xml file for the following line :
  
 
<menu category="home" status="<span style="color:red">'''off'''</span>"/>
 
<menu category="home" status="<span style="color:red">'''off'''</span>"/>
  
==Exemple 3 : Cacher le panel "Display"==
+
==Example 3 : How to hide the "Display" panel==
  
Afin de cacher l'onglet "display", il faut passer la ligne suivante du '''global.xml''' à la valeur OFF :
+
In order to hide the '''Display''' tab, we need to change the status to '''off''' in the global.xml file for the following line :
  
 
<menu category="view" status="<span style="color:red">'''off'''</span>"/>
 
<menu category="view" status="<span style="color:red">'''off'''</span>"/>
 +
 +
 +
 +
mots clés : Interface designer, personnaliser Designer, Designer Custom, Designer light, Comment personnaliser l'interface de Designer

Version actuelle datée du 4 août 2020 à 08:55

Autres langues :
English • ‎français


In the following versions, it will also be possible to customize other tool bars and windows and also change the colours in order to fully customize the interface.

prerequisites

  • Designer ONYX 10.1 or above
  • Having the global.xml file in the Styles folder in the Designer installation folder
  • Executing the initGlobalStyle.reg file included in the setup

Limits

This first version gives only the possibility to modify the buttons of the Ruban bar located at the top the screen. Other possibilities will come next.

How to hide ribbon tool bar elements

It is possible to hide certain buttons of the Home, Edit, Display, Shape or Mapping tab. It is also possible to hide the entire tab.

OX D CUSTOM1.jpg


The global Style is to hide the categories, panels and buttons based on the global.xml file. This file must be located in the Styles subfolder of the Designer installation folder.


global.xml installation file

In order to customize the ribbon, we must first execute the initGlobalStyle.reg. It will add a registery key with the xml file containing the elements to hide. (by default : global.xml)

Windows Registry Editor Version 5.00
[HKEY_CURRENT_USER\SOFTWARE\Mapping\M-Designer\Settings]
"GlobalStyle"="global.xml"


If the station is used by several different users, each can have its own style file. To do so, duplicate the global.xml file in order to obtain one file per user, for example: nicolas.xml, jerome.xml.

Then, adapt the initGlobalStyle.reg file for each user in order to modify their respective registry key according to the style to be applied.


Exemple :

Nicolas :

Windows Registry Editor Version 5.00
[HKEY_CURRENT_USER\SOFTWARE\Mapping\M-Designer\Settings]
"GlobalStyle"="nicolas.xml"


Jérôme :

Windows Registry Editor Version 5.00
[HKEY_CURRENT_USER\SOFTWARE\Mapping\M-Designer\Settings]
"GlobalStyle"="jerome.xml"

Setting up the XML file

The XML file contains the same nodes as the former style file with the <style> node.

We add a '<ui>' node which will contain a list of '<menu>' nodes. These will correspond to the categories, panels and buttons to display or delete:


<?xml version="1.0" encoding="utf-8"?>

<style>
       <ui>
             <menu category="xxxxx" panel="xxxxx" id="xxxxx" status="on|off" />
             <menu ... />
                 ...
       </ui>
</style>

The <menu> node can have the following attributes :

  • category: Name of the element category
  • panel: Name of the element panel
  • id: name of the element button to hide or display
  • status: value indicating whether we display the element (“on”) or not (“off”)


In the following example, the generate project button, the Insert panel and the format category will not be displayed in the Designer interface.

<?xml version="1.0" encoding="utf-8"?>

<style>
        <ui>
               <menu category="home" panel="generate" id="generate_btn" status="off"/>
               <menu category="format" status="off"/>
               <menu category="shape" panel="insert" status="off"/>
        </ui>
</style>

The non specified elements has by default the value on.

List of names

The panels and buttons located in multiple categories must be specified in the home category and will be hidden in all categories.

Categories

The categories represent in the interface the tabs.

OX D CUSTOM6.jpg


Categorie @category
Edit format
Home home
Mapping Mapping
Shape shape
Display view

Example :

<menu category="format" status="on"/>
<menu category="view" status="off"/>

Panels

The panels represent in the interface the button blocs.

OX D CUSTOM7.jpg


Panneaux @panel
Clipboard clipboard
Data data
Position according to grid fit_to_grid
Shapes form
Generate generate
Generate (component) generate_component
Insert insert
Insert (Mapping) insert_dynamic
Organize organize
Preview preview
Refresh redraw
Styles styles
Window window

Example :

<menu category="shape" panel="insert" status="on"/>
<menu category="shape" panel="form" status="off"/>

Buttons

The buttons represent in the interface the buttons or other lowest level objects.

OX D CUSTOM8.jpg


OX D CUSTOM2.jpg
OX D CUSTOM3.jpg
OX D CUSTOM4.jpg
OX D CUSTOM5.jpg


Buttons @id
Paste paste
Cut cut
Copy copy
Copy Formatting copy_format
Duplicate duplicate
font group font_group
Text Style txt_style
Text Alignment txt_align
Colour Font font_color
Generate Project generate_btn
Project association associate
Export Overlay export_printer
Script script
Send to mapping send
Send multi to mapping send_multi
Preview preview_btn
Load Data Stream open_spool
Multi-Preview multi_preview
Save Preview save_preview
XPS Watermark xps_layer
Unlink the spool unlink_spool
XML Preprocessing process_xml
Bring to Front layer_front
Bring to Back layer_back
Alignment ids-alignment
Size ids_size
Rotate ids_rotate
Snap to grid magnet
Grid Setup grid_setup
Text box text_box
Image image_box
Static table table_box
Select selection
Line line
Arch arc
Square square
Rectangle rectangle
Rounded rectangle curved_rectangle
Ellipse ellipse
Circle circle
Shapes figure
Pen color outline_color
Fill padding_color
Pen weight
zone mapzone
Anchor anchor
Fix group mapgroup
Variable group mapgroup_var
Commands commands
Select (mapping tab) mapselection
Line (mapping tab) mapline
Rectangle (mapping tab) maprectangle
text box (mapping tab) maptext
Logo (mapping tab) maplogo
Graph mapgraph
Component mapcomponent
Variable element maplabel

Example :

<menu category="home" panel="preview" id="preview_btn" status="on"/>
<menu category="home" panel="preview" id="open_spool" status="off"/>


Example 1 : How to hide the "Generate Project" button

In order to hide the Generate Project, we must add the following line or change it if already existing to the following :

<menu category="home" panel="generate" id="generate_btn" status="off"/>

Example 2 : How to hide the "Home" tab

In order to hide the Home tab, we need to change the status to off in the global.xml file for the following line :

<menu category="home" status="off"/>

Example 3 : How to hide the "Display" panel

In order to hide the Display tab, we need to change the status to off in the global.xml file for the following line :

<menu category="view" status="off"/>


mots clés : Interface designer, personnaliser Designer, Designer Custom, Designer light, Comment personnaliser l'interface de Designer