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

Différence entre versions

De MappingDoc
(Page créée avec « ONYX:Utilization:How to custom the GUI interface of Designer »)
 
 
(62 révisions intermédiaires par 3 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
 
<languages/>
 
<languages/>
  
Onyx Designer 10.1 (sortie officielle Fin Juin 2020) et au-de-là donne la possibilité de personnaliser son interface.
 
  
 +
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.
  
Dans une prochaine version, il sera également possible de personnaliser les autres barres d'outils et fenêtres de Designer ainsi que de modifier les couleurs.
+
==How to hide  ribbon tool bar elements==
  
==Prérequis==
+
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.
*'''Designer Onyx 10.1''' ou supérieur
+
 
*Avoir le fichier '''global.xml''' dans le répertoire '''Styles''' du dossier d'installation de Designer
+
[[File:OX_D_CUSTOM1.jpg|1000px|center|sans_cadre]]
*Exécuter le fichier '''initGlobalStyle.reg''' fourni avec le setup
+
 
 +
 
 +
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.
  
==Limites==
 
Cette première version permets uniquement de jouer avec les bouton de la barre d'outils Ruban situé en haut de l'écran. D'autres possibilités viendront pas la suite.
 
  
==Masquer des éléments du ruban==
+
===global.xml installation file===
  
Il est possible de cacher certains boutons des onglets '''Home''', '''Edit''', '''Display''' et '''Shape'''
+
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)
  
[[File:OX_D_CUSTOM1.jpg|1000px|center|sans_cadre]]  
+
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"
  
  
L’ajout du Style global permet de masquer des catégories, des panels et des boutons à partir du fichier global.xml. Ce fichiers se trouve dans le dossier d’installation de M-Designer, dans le dossier '''“Styles”'''.
 
  
 +
'''Jérôme : '''
 +
Windows Registry Editor Version 5.00
 +
[HKEY_CURRENT_USER\SOFTWARE\Mapping\M-Designer\Settings]
 +
"GlobalStyle"="jerome.xml"
  
===Installation du fichier global.xml===
+
===Setting up the XML file===
  
Afin d’activer la personnalisation du ruban, il faut exécuter le fichier initGlobalStyle.reg. Ce dernier va ajouter une clé avec le nom du fichier XML contenant les éléments à masquer.
+
The XML file contains the same nodes as the former style file with the <style> node.
  
===Paramétrage du fichier XML===
+
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:
  
Le fichier XML reprends les même balise que les autre fichier de style avec la balise <style>. On y ajoute une balise <ui> qui contiendra une liste de balises <menu>. Ces dernières correspondront au catégories, panneaux et boutons à afficher ou supprimer:
+
<?xml version="1.0" encoding="utf-8"?>
+
<?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 42 : Ligne 66 :
 
  </style>
 
  </style>
  
La balise menu peut avoir les attributs suivant:
+
The '''<menu>''' node can have the following attributes :
  
*'''category''': indiquant le nom de la catégorie de l'élément
+
*'''category''': Name of the element category
*'''panel''': indiquant le nom du panel de l'élément
+
*'''panel''': Name of the element panel
*'''id''': indiquant le nom du bouton de l'élément
+
*'''id''': name of the element button to hide or display
*'''status''': valeur indiquant si l'élément doit s’afficher ('''“on”''') ou non ('''“off”''')
+
*'''status''': value indicating whether we display the element ('''“on”''') or not ('''“off”''')
 
<br>
 
<br>
<u>Remarque</U> : Si on souhaite supprimer uniquement un bouton il faudra ajouter les quatre attributs à la balise menu. En revanche si, on veut supprimer une catégorie, il ne faudra ajouter que les attribut category et status. De même, si on souhaite enlever un panneau, il ne faudra mettre que les attributs category, panel et status.
 
  
Dans l’exemple ci-dessous, Le bouton “générer”, le panneau “insérer” et la catégorie “format” n’apparaitront pas dans M-Designer:
+
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"?>
 
  <style>
 
  <style>
 
         <ui>
 
         <ui>
Ligne 61 : Ligne 85 :
 
  </style>
 
  </style>
  
Les '''éléments non renseignés''' sont au status '''“on”''' par défaut.
+
The '''non specified elements''' has by default the value '''on'''.
  
===Liste des noms===
+
===List of names===
  
Les panneaux et boutons se trouvant dans plusieurs catégories doivent être mis dans la catégorie Accueil (home) et seront supprimer dans toutes les catégories.
+
The panels and buttons located in multiple categories must be specified in the '''home''' category and will be hidden in all categories.
  
====Catégories====
+
====Categories====
  
Les catégories représentent au niveau de l'interface les onglets.
+
The categories represent in the interface the '''tabs'''.
  
 
[[File:OX_D_CUSTOM6.jpg|1000px|center|sans_cadre]]  
 
[[File:OX_D_CUSTOM6.jpg|1000px|center|sans_cadre]]  
Ligne 76 : Ligne 100 :
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
! Catégorie !! Attribut XML
+
! Categorie !! @category
 
|-
 
|-
| Mise en forme || format
+
| Edit || format
 
|-
 
|-
| Accueil || home
+
| Home || home
 
|-
 
|-
 
| Mapping || Mapping
 
| Mapping || Mapping
 
|-
 
|-
| Forme || shape
+
| Shape || shape
 
|-
 
|-
| Affichage || view
+
| Display || view
 
|}
 
|}
  
 +
Example :
 +
<menu category="format" status="on"/>
 +
<menu category="view" status="off"/>
  
====Panneaux====
+
====Panels====
  
Les catégories représentent au niveau de l'interface les blocs de boutons.
+
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 99 : Ligne 126 :
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
! Panneaux !! Attribut XML
+
! Panneaux !! @panel
 
|-
 
|-
| Presse-papier || clipboard
+
| Clipboard || clipboard
 
|-
 
|-
| Texte de la cellule || clipboard
+
| Data || data
 
|-
 
|-
| Donnée || data
+
| Position according to grid || fit_to_grid
 
|-
 
|-
| Positionner selon la grille || fit_to_grid
+
| Shapes || form
 
|-
 
|-
| Formes || form
+
| Generate || generate
 
|-
 
|-
| Générer || generate
+
| Generate (component) || generate_component
 
|-
 
|-
| Générer (composant) || generate_component
+
| Insert || insert
 
|-
 
|-
| Insérer || insert
+
| Insert (Mapping) || insert_dynamic
 
|-
 
|-
| Insérer (Mapping) || insert_dynamic
+
| Organize || organize
 
|-
 
|-
| Organiser || organize
+
| Preview || preview
 
|-
 
|-
| Prévisualiser || preview
+
| Refresh || redraw
|-
 
| Redessiner || redraw
 
 
|-
 
|-
 
| Styles || styles
 
| Styles || styles
 
|-
 
|-
| Fenêtre || window
+
| Window|| window
 
|}
 
|}
  
====Boutons====
+
Example :
 +
<menu category="shape" panel="insert" status="on"/>
 +
<menu category="shape" panel="form" status="off"/>
  
Les catégories représentent au niveau de l'interface les boutons ou équivalents.
+
====Buttons====
 +
 
 +
The buttons represent in the interface the '''buttons''' or other '''lowest level objects'''.
  
 
[[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"
 
|-
 
|-
! Boutons !! Attribut XML
+
! Buttons !! @id
 
|-
 
|-
| Coller || paste
+
| Paste|| paste
 
|-
 
|-
| Couper || cut
+
| Cut|| cut
 
|-
 
|-
| Copier|| copy
+
| Copy|| copy
 
|-
 
|-
| Copier le format || copy_format
+
| Copy Formatting || copy_format
 
|-
 
|-
| Dupliquer|| '''dupplicate'''
+
| Duplicate || duplicate
 
|-
 
|-
| Police et taille|| font_group
+
| font group || font_group
 
|-
 
|-
| Style du texte|| txt_style
+
| Text Style || txt_style
 
|-
 
|-
| alignement || txt_align
+
| Text Alignment || txt_align
 
|-
 
|-
| couleur de la police || font_color
+
| Colour Font || font_color
 
|-
 
|-
| générer || generate_btn
+
| Generate Project || generate_btn
 
|-
 
|-
| Association de projet|| associate
+
| Project association || associate
 
|-
 
|-
| Exporter FDP || export_printer
+
| Export Overlay || export_printer
 
|-
 
|-
 
| Script || script
 
| Script || script
 
|-
 
|-
| Envoi mapping || send
+
| Send to mapping || send
 
|-
 
|-
| Envoi mapping multi || send_multi
+
| Send multi to mapping || send_multi
 
|-
 
|-
| Aperçu || preview_btn
+
| Preview || preview_btn
 
|-
 
|-
| Charger flux de données || open_spool
+
| Load Data Stream || open_spool
 
|-
 
|-
| Aperçu multiple || multi_preview
+
| Multi-Preview || multi_preview
 
|-
 
|-
| Enregistrer apperçu || save_preview
+
| Save Preview || save_preview
 
|-
 
|-
| Calque XPS || xps_layer
+
| XPS Watermark || xps_layer
 
|-
 
|-
| Délier spool || unlink_spool
+
| Unlink the spool || unlink_spool
 
|-
 
|-
| Prétraitement XML || process_xml
+
| XML Preprocessing || process_xml
 
|-
 
|-
| Mettre dessus || layer_front
+
| Bring to Front || layer_front
 
|-
 
|-
| Mettre dessous || layer_back
+
| Bring to Back || layer_back
 
|-
 
|-
| Alignement || ids-alignment
+
| Alignment || ids-alignment
 
|-
 
|-
| Taille || ids_size
+
| Size || ids_size
 
|-
 
|-
| Rotation || ids_rotate
+
| Rotate || ids_rotate
 
|-
 
|-
| Aimanter|| magnet
+
| Snap to grid || magnet
 
|-
 
|-
| Régler le pas de la grille || grid_setup
+
| Grid Setup || grid_setup
 
|-
 
|-
| text || text_box
+
| Text box || text_box
 
|-
 
|-
 
| Image || image_box
 
| Image || image_box
 
|-
 
|-
| Tableau statique || table_box
+
| Static table || table_box
 
|-
 
|-
| Sélection || selection
+
| Select || selection
 
|-
 
|-
| Ligne || line
+
| Line || line
 
|-
 
|-
| Arc || arc
+
| Arch || arc
 
|-
 
|-
| Carré || square
+
| Square || square
 
|-
 
|-
| Rectangle|| rectangle
+
| Rectangle || rectangle
 
|-
 
|-
| Rectangle arrondi|| curved_rectangle
+
| Rounded rectangle || curved_rectangle
 
|-
 
|-
 
| Ellipse|| ellipse
 
| Ellipse|| ellipse
 
|-
 
|-
| Cercle || circle
+
| Circle || circle
 
|-
 
|-
| Formes || figure
+
| Shapes || figure
 
|-
 
|-
| Couleur du contour || outline_color
+
| Pen color || outline_color
 
|-
 
|-
| Couleur de remplissage || padding_color
+
| Fill || padding_color
 
|-
 
|-
| Epaisseur || weight
+
| Pen || weight
 
|-
 
|-
| zone|| mapzone
+
| zone || mapzone
 
|-
 
|-
| Ancre|| anchor
+
| Anchor || anchor
 
|-
 
|-
| Groupe Fixe || mapgroup
+
| Fix group || mapgroup
 
|-
 
|-
| Groupe Variable || mapgroup_var
+
| Variable group || mapgroup_var
 
|-
 
|-
| Commandes || commands
+
| Commands || commands
 
|-
 
|-
| Sélection (onglet mapping) || mapselection
+
| Select (mapping tab) || mapselection
 
|-
 
|-
| Ligne (onglet mapping) || mapline
+
| Line (mapping tab) || mapline
 
|-
 
|-
| Rectangle || maprectangle
+
| Rectangle (mapping tab) || maprectangle
 
|-
 
|-
| text || maptext
+
| text box (mapping tab) || maptext
 
|-
 
|-
| Logo || maplogo
+
| Logo (mapping tab) || maplogo
 
|-
 
|-
| Graphique || mapgraph
+
| Graph || mapgraph
 
|-
 
|-
| Composant || mapcomponent
+
| Component || mapcomponent
 
|-
 
|-
| Elément variable || maplabel
+
| Variable element || maplabel
 
|}
 
|}
  
[[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>
  
==Exemple 1 : Cacher le bouton "Generate Project"==
+
==Example 1 : How to hide the "Generate Project" button==
  
Afin de cacher le bouton "Generate Project", il faut passer la ligne suivante du '''global.xml''' à la valeur OFF :
+
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="<span style="color:red">'''off'''</span>"/>
 
  <menu category="home" panel="generate" id="generate_btn" status="<span style="color:red">'''off'''</span>"/>
  
==Exemple 2 : Cacher l'onglet "Home"==
+
==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