Commandes

Identificateur : org.eclipse.ui.commands

Depuis la

version 2.1

Description :

Le point d'extension org.eclipse.ui.commands déclare des commandes et des catégories de commande à l'aide des éléments command et category. Il permet également d'affecter des séquences de touches à des commandes à l'aide de l'élément keyBinding. Les séquences de touches sont liées à des commandes basées sur des configurations et des portées de touches également déclarées ici à l'aide des éléments keyConfiguration et scope.

Marques de configuration :

   <!ELEMENT extension (activeKeyConfiguration , category , command , keyBinding , keyConfiguration , scope)>

   <!ATTLIST extension
     id    CDATA #IMPLIED
     name  CDATA #IMPLIED
     point CDATA #REQUIRED
   >

   <!ELEMENT activeKeyConfiguration EMPTY>

   Cet élément définit la configuration de touches initiale d'Eclipse. En présence de plusieurs éléments, seul le dernier déclaré (dans l'ordre de lecture du registre des plug-in) est pris en compte.

   <!ATTLIST activeKeyConfiguration
     value CDATA #IMPLIED
   >

   <!ELEMENT category EMPTY>

   Pour en faciliter la gestion, les commandes sont souvent regroupées par catégories dans l'interface utilisateur. Cet élément permet de définir ces catégories. Une commande ne peut appartenir qu'à une catégorie. Si le même attribut id contient plusieurs de ces éléments, seul le dernier déclaré (dans l'ordre de lecture du registre des plug-in) est pris en compte.

   <!ATTLIST category
     description CDATA #IMPLIED
      id          CDATA #REQUIRED
     nom        CDATA #REQUIRED
   >

   <!ELEMENT command EMPTY>

   Cet élément définit des commandes. Une commande correspond à une demande de l'utilisateur pouvant être traitée par une action et don tla syntaxe doit être unique comparée à celle des autres commandes. Ne définissez pas une commande s'il en existe déjà une ayant le même objectif. Si le même attribut id contient plusieurs de ces éléments, seul le dernier déclaré (dans l'ordre de lecture du registre des plug-in) est pris en compte.Pour comprendre comment les actions sont liées aux commandes, reportez-vous aux points d'extension org.eclipse.ui.actionSets et org.eclipse.ui.editorActions.

   <!ATTLIST command
     category    CDATA #IMPLIED
     description CDATA #IMPLIED
      icon        CDATA #IMPLIED
      id          CDATA #REQUIRED
     name        CDATA #REQUIRED
   >

   <!ELEMENT keyBinding EMPTY>

   Cet élément attribue des séquences de touches aux commandes.

   <!ATTLIST keyBinding
     configuration CDATA #REQUIRED
     command       CDATA #IMPLIED
     locale        CDATA #IMPLIED
     platform      CDATA #IMPLIED
     scope         CDATA #REQUIRED
     string        CDATA #REQUIRED
   >

   <!ELEMENT keyConfiguration EMPTY>

   Cet élément définit des configurations de touches. Si le même attribut id contient plusieurs de ces éléments, seul le dernier déclaré (dans l'ordre de lecture du registre des plug-in) est pris en compte.

   <!ATTLIST keyConfiguration
     description CDATA #IMPLIED
      id          CDATA #REQUIRED
     name        CDATA #REQUIRED
     parent      CDATA #IMPLIED
   >

   <!ELEMENT scope EMPTY>

   Cet élément définit des portées. Si le même attribut id contient plusieurs de ces éléments, seul le dernier déclaré (dans l'ordre de lecture du registre des plug-in) est pris en compte.

   <!ATTLIST scope
     description CDATA #IMPLIED
      id          CDATA #REQUIRED
     name        CDATA #REQUIRED
     parent      CDATA #IMPLIED
   >
Exemples :

Le fichier plugin.xml du plug-in org.eclipse.ui utilise extensivement le point d'extension org.eclipse.ui.commands.

Informations d'API:

Il n'existe pas d'API publiques de déclaration de commandes, catégories, liaison de touches, configurations de touches ou portées hormis ce point d'extension. Les API publiques de requête et de définition de portées, ainsi que d'enregistrement d'actions pour le traitement de commandes spécifiques se trouvent dans org.eclipse.ui.IKeyBindingService.

Copyright (c) 2000, 2003 IBM Corporation and others.
All rights reserved. Ce programme et les produits qui l'accompagnent sont fournis sous licence v1.0 associée à cette distribution et disponibles à l'adresse suivante : http://www.eclipse.org/legal/cpl-v10.html