Vues
Identificateur :
org.eclipse.ui.views
Description :
Ce point
d'extension sert à définir des vues supplémentaires dans le plan de
travail. Une vue est un composant visuel d'une page du plan de travail généralement
utilisé pour naviguer dans une hiérarchie d'informations (telle que l'espace de travail), ouvrir un éditeur ou afficher les propriétés de l'éditeur actif. L'utilisateur peut afficher une vue à partir du menu Fenêtre > Afficher la vue ou la fermer à partir de sa barre de titre locale.
Afin de réduire la charge visuelle dans la boîte de dialogue
Affichage de la vue, les vues doivent être regroupées par catégorie.
Marques de configuration :
<!ELEMENT extension (category | view | stickyView)*>
<!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
category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - nom unique qui sera utilisé pour identifier cette
catégorie
- name - nom traduisible qui sera utilisé dans l'interface
pour cette catégorie
- parentCategory - chemin d'accès facultatif, composé
d'ID catégorie séparés par une barre oblique (/). Cela permet la création d'une hiérarchie de catégorie.
<!ELEMENT view (description?)>
<!ATTLIST view
id CDATA #REQUIRED
name CDATA #REQUIRED
category CDATA #IMPLIED
class CDATA #REQUIRED
icon CDATA #IMPLIED
fastViewWidthRatio CDATA #IMPLIED
allowMultiple (true | false) >
- id - nom unique qui sera utilisé pour identifier cette vue
- name - nom traduisible qui sera utilisé dans l'interface
pour cette vue
- category - attribut facultatif, composé des ID
catégorie séparés par une barre oblique (/). Chaque catégorie référencée doit être déclarée dans un élément de catégorie correspondant.
- class - nom qualifié complet de la classe implémentant org.eclipse.ui.IViewPart. Une pratique courante consiste à sous-classer org.eclipse.ui.part.ViewPart afin d'hériter de la fonctionnalité par défaut.
- icon - nom relatif de l'icône associé à la vue.
- fastViewWidthRatio - pourcentage de la largeur du plan
de travail que la vue occupera en tant que vue rapide active.
Ce
pourcentage doit être défini comme valeur de virgule flottante et
être compris entre 0,05 et 0,95.
Si aucune valeur n'est
indiquée, le rapport par défaut est appliqué.
- allowMultiple - indique si cette vue permet la création
de plusieurs instances avec IWorkbenchPage.showView(String id, String
secondaryId). La valeur par défaut est false.
<!ELEMENT description (#PCDATA)>
un sous-élément facultatif dont le corps doit contenir une brève
description de la vue.
<!ELEMENT stickyView EMPTY>
<!ATTLIST stickyView
id CDATA #REQUIRED
location (RIGHT|LEFT|TOP|BOTTOM)
closeable (true | false)
moveable (true | false) >
Une vue permanente apparaît par défaut dans toutes les perspectives
d'une fenêtre après ouverture. Son emplacement initial dépend
de l'attribut location, même si elle peut être déplacée et fermée par
l'utilisateur. L'utilisation de cet élément entraîne uniquement la
création d'une marque de réservation et n'affiche pas la vue. Utilisez-le avec précaution et appliquez-le uniquement à des vues
devant impérativement exister dans toutes les perspectives.
Depuis 3.0
- id - ID de la vue à rendre permanente.
- location - attribut facultatif indiquant
l'emplacement de la vue permanente par rapport à la zone de
l'éditeur. S'il n'est pas mentionné, la vue sera ancrée à droite de
la zone de l'éditeur.
- closeable - attribut facultatif indiquant si la vue
doit pouvoir être fermée. S'il n'est pas mentionné, le vue peut être
fermée.
- moveable - attribut facultatif indiquant si la vue
doit pouvoir être déplacée. S'il n'est pas mentionné, la vue est
déplaçable.
Exemples :
L'exemple
ci-dessous illustre le point d'extension :
<extension point=
"org.eclipse.ui.views"
>
<category
id=
"com.xyz.views.XYZviews"
name=
"XYZ"
/>
<view
id=
"com.xyz.views.XYZView"
name=
"Vue XYZ"
category=
"com.xyz.views.XYZviews"
class=
"com.xyz.views.XYZView"
icon=
"icons/XYZ.gif"
/>
</extension>
L'exemple ci-dessous illustre une déclaration de vue permanente :
<extension point=
"org.eclipse.ui.views"
>
<stickyView
id=
"com.xyz.views.XYZView"
/>
</extension>
Informations d'API :
La
valeur de l'attribut class doit correspondre au nom
qualifié complet d'une classe implémentant org.eclipse.ui.IViewPart. Une
pratique courante consiste à sous-classer org.eclipse.ui.part.ViewPart
lors du développement d'une nouvelle vue.
Implémentation fournie :
La plateforme Eclipse offre un nombre de vues standard comprenant les vues Navigateur, Propriétés, Structure et Tâches. Du
point de vue de l'utilisateur, ces vues ne sont pas différentes des
autres vues fournies par les plug-ins. Toutes
les vues peuvent être affichées via le sous-menu Afficher la vue du
menu Fenêtre. La position d'une vue est persistante.
Autrement dit, elle est sauvegardée lorsque la vue est fermée et restaurée lorsque la vue est rouverte dans une seule
session. La position est également conservée entre les sessions du plan de travail.
Copyright (c) 2002, 2005 IBM Corporation and others.
All rights reserved. Ce programme et les produits associés sont
distribués sous licence v1.0 et disponibles à
l'adresse suivante :
http://www.eclipse.org/legal/epl-v10.html