Mandatos

Identificador: org.eclipse.ui.commands

A partir del:

Release 2.1

Descripción:

El punto de extensión org.eclipse.ui.commands se utiliza para declarar mandatos y categorías de mandatos, mediante los elementos command y category. Mediante este punto de extensión, también pueden asignarse secuencias de teclas a los mandatos utilizando el elemento keyBinding. Las secuencias de teclas se enlazan con los mandatos en función de ámbitos y configuraciones de teclas que también se declaran en este punto, mediante los elementos keyConfiguration y scope.

Códigos XML de configuración:

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

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

   <!ELEMENT activeKeyConfiguration EMPTY>

   Este elemento se utiliza para definir la configuración de teclas activa inicial de Eclipse. Si existe más de uno de estos elementos, sólo se considera válido el último elemento declarado (por orden de lectura del registro de conectores).

   <!ATTLIST activeKeyConfiguration
     value CDATA #IMPLIED
   >

   <!ELEMENT category EMPTY>

   En la UI, los mandatos están organizados frecuentemente por categorías para facilitar su gestión. Este elemento se utiliza para definir estas categorías. Los mandatos pueden añadirse a sí mismos a una categoría como máximo. Si existe más de uno de estos elementos con el mismo atributo id, sólo se considera válido el último elemento declarado (por orden de lectura del registro de conectores).

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

   <!ELEMENT command EMPTY>

   Este elemento se utiliza para definir mandatos. Un mandato representa una petición del usuario que puede manejarse mediante una acción, y debe ser semánticamente exclusivo con respecto a otros mandatos. No defina un mandato si ya existe uno definido con el mismo significado. Si existe más de uno de estos elementos con el mismo atributo id, sólo se considera válido el último elemento declarado (por orden de lectura del registro de conectores). Consulte los puntos de extensión org.eclipse.ui.actionSets y org.eclipse.ui.editorActions para saber cómo se conectan las acciones a los mandatos.

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

   <!ELEMENT keyBinding EMPTY>

   Este elemento permite asignar secuencias de teclas a los mandatos.

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

   <!ELEMENT keyConfiguration EMPTY>

   Este elemento se utiliza para definir configuraciones de teclas. Si existe más de uno de estos elementos con el mismo atributo id, sólo se considera válido el último elemento declarado (por orden de lectura del registro de conectores).

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

   <!ELEMENT scope EMPTY>

   Este elemento se utiliza para definir ámbitos. Si existe más de uno de estos elementos con el mismo atributo id, sólo se considera válido el último elemento declarado (por orden de lectura del registro de conectores).

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

El archivo plugin.xml del conector org.eclipse.ui utiliza ampliamente el punto de extensión org.eclipse.ui.commands.

Información sobre las API:

No existe una API de uso público para declarar mandatos, categorías, enlaces de teclas, configuraciones de teclas o ámbitos aparte de este punto de extensión. La API de uso público destinada a declarar y establecer ámbitos, así como para registrar acciones para manejar mandatos específicos, puede encontrarse en org.eclipse.ui.IKeyBindingService.

Copyright (c) 2000, 2003 IBM Corporation y otros.
Reservados todos los derechos. Este programa y sus materiales adjuntos están disponibles bajo los términos de la licencia pública común (Common Public License) v1.0 que acompaña a esta distribución, y está disponible en http://www.eclipse.org/legal/cpl-v10.html