Extensions de perspective
Identificateur :
org.eclipse.ui.perspectiveExtensions
Description :
Ce point
d'extension sert à étendre des perspectives enregistrées par d'autres plug-ins. Une perspective définit le contenu initial des barres d'action (menu et
barre d'outils) de la fenêtre, ainsi que le jeu de vues initial et leur
présentation dans la page du plan de travail.
D'autres plug-ins peuvent ajouter des actions et des vues à la perspective
qui apparaissent lorsque la perspective est sélectionnée. Des
ajouts facultatifs par d'autres plug-ins ont lieu pour la définition
initiale.
Marques de configuration :
<!ELEMENT extension (perspectiveExtension*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - identificateur qualifié complet du point d'extension
cible.
- id - identificateur facultatif de l'instance d'extension.
- name - nom facultatif de l'instance d'extension.
<!ELEMENT perspectiveExtension (actionSet | viewShortcut | perspectiveShortcut | newWizardShortcut | view | showInPart)*>
<!ATTLIST perspectiveExtension
targetID CDATA #REQUIRED>
- targetID - identificateur unique de la perspective
(comme spécifié dans le registre) dans lequel la contribution est réalisée.
<!ELEMENT actionSet EMPTY>
<!ATTLIST actionSet
id CDATA #REQUIRED>
- id - identificateur unique du jeu d'actions ajouté à la perspective.
<!ELEMENT viewShortcut EMPTY>
<!ATTLIST viewShortcut
id CDATA #REQUIRED>
- id - identificateur unique de la vue qui sera ajoutée au
sous-menu Afficher la vue de la perspective, dans le menu Fenêtre.
<!ELEMENT perspectiveShortcut EMPTY>
<!ATTLIST perspectiveShortcut
id CDATA #REQUIRED>
- id - identificateur unique de la perspective qui sera
ajouté au sous-menu Ouvrir la perspective, dans le menu Fenêtre.
<!ELEMENT newWizardShortcut EMPTY>
<!ATTLIST newWizardShortcut
id CDATA #REQUIRED>
- id - identificateur unique du nouvel assistant qui sera
ajouté au sous-menu Nouveau de la perspective, dans le menu Fichier.
<!ELEMENT showInPart EMPTY>
<!ATTLIST showInPart
id CDATA #IMPLIED>
- id - identificateur unique de la vue ajoutée à l'invite
"Afficher dans" de la perspective dans le menu Naviguer.
<!ELEMENT view EMPTY>
<!ATTLIST view
id CDATA #REQUIRED
relative CDATA #IMPLIED
relationship (stack|left|right|top|bottom|fast)
ratio CDATA #IMPLIED
visible (true | false)
closeable (true | false)
moveable (true | false)
standalone (true | false)
showTitle (true | false) >
- id - identificateur unique de la vue ajoutée à la
présentation de la perspective.
- relative - identificateur unique d'une vue qui existe déjà dans
la perspective. Il sera utilisé comme point de référence pour le placement
de la vue. La relation entre ces deux vues est définie par l'attribut
relationship. Ignoré si la relation est "fast".
- relationship - spécifie la relation entre id et
relative.
Les valeurs suivantes sont admises :
fast - extension de vue qui sera créée en tant que vue rapide.
stack - extension de la vue qui sera empilée sur
la vue relative dans un dossier.
left, right, top, bottom - extension de la vue qui sera placée
à côté de la vue relative. Dans ce cas, un ratio (rapport)
doit être également défini.
- ratio - pourcentage de zone dans la vue relative qui sera
attribué à l'extension de la vue. Si cette dernière est une vue
rapide, le rapport est le pourcentage du plan de travail qu'elle
couvrira lorsqu'elle sera active. Ce pourcentage doit être défini
comme valeur de virgule flottante et être compris entre 0,05
et 0,95.
- visible - si la vue est initialement visible à
l'ouverture de la perspective. Cet attribut doit avoir une valeur
"true" ou "false" s'il est utilisé.
Sinon, la vue sera par défaut visible initialement.
- closeable - si la vue peut être fermée dans la perspective
cible. Cet attribut doit avoir une valeur
"true" ou "false" s'il est utilisé. Si cet attribut n'est pas
employé, la vue pourra être fermée, sauf si la perspective est
signalée comme fixe.
- moveable - si la vue peut être déplacée. Une vue non
déplaçable ne peut être déplacée ni à l'intérieur dans le dossier où
elle figure, ni entre des dossiers de la perspective. Cet attribut doit avoir une valeur
"true" ou "false" s'il est utilisé.
Si cet attribut n'est pas utilisé, la vue sera déplaçable, sauf si
la perspective est signalée comme fixe.
- standalone - si la vue est autonome. Une vue autonome ne peut être ancrée à d'autres dans le même
dossier. Cet attribut doit avoir une valeur
"true" ou "false" s'il est utilisé. Il est ignoré si l'attribut
relationship a la valeur "fast" ou "stacked". S'il n'est pas employé,
la vue sera standard et non autonome ("false" par défaut).
- showTitle - si le titre de la vue apparaît. Cet attribut doit avoir une valeur
"true" ou "false" s'il est utilisé. Cet attribut s'applique
uniquement à des vues autonomes. S'il n'est pas employé, le titre de
la vue apparaît ("true" par défaut).
Exemples :
L'exemple
ci-dessous illustre une extension de perspective (notez les
sous-éléments et le mode d'utilisation des attributs) :
<extension point=
"org.eclipse.ui.perspectiveExtensions"
>
<perspectiveExtension
targetID=
"org.eclipse.ui.resourcePerspective"
>
<actionSet id=
"org.eclipse.jdt.ui.JavaActionSet"
/>
<viewShortcut id=
"org.eclipse.jdt.ui.PackageExplorer"
/>
<newWizardShortcut id=
"org.eclipse.jdt.ui.wizards.NewProjectCreationWizard"
/>
<perspectiveShortcut id=
"org.eclipse.jdt.ui.JavaPerspective"
/>
<view id=
"org.eclipse.jdt.ui.PackageExplorer"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"stack"
/>
<view id=
"org.eclipse.jdt.ui.TypeHierarchy"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"left"
ratio=
"0.50"
/>
</perspectiveExtension>
</extension>
Dans l'exemple ci-dessus, un jeu d'actions, un raccourci de vue, un
raccourci de nouvel assistant et un raccourci de perspective sont ajoutés
au contenu initial de la perspective des ressources. De plus, la vue
"Package Explorer" est empilée sur la vue du navigateur de ressources, à
côté de laquelle est ajoutée la vue Hiérarchie des types.
Informations d'API :
Les
éléments définis dans l'extension de la perspective sont
contribués au contenu initial de la perspective cible. L'utilisateur peut supprimer tout ajout et ajouter
d'autres éléments à une perspective à partir de l'interface du plan de
travail.
Copyright (c) 2002, 2004 IBM Corporation and others.
All rights reserved. Ce programme et les produits associés sont distribués sous licence Eclipse v1.0 et disponibles à l'adresse suivante :http://www.eclipse.org/legal/epl-v10.html