Comandos

Identificador: org.eclipse.ui.commands

Desde:

2.1

Descrição:

O ponto de extensão org.eclipse.ui.commands é utilizado para declarar comandos e categorias de comandos usando os elementos command e category. Através desse ponto de extensão, também é possível atribuir seqüências de teclas para comandos utilizando o elemento keyBinding. As seqüências de teclas são ligadas aos comandos com base nas configurações de teclas e nos escopos declarados neste documento, bem como através da utilização dos elementos keyConfiguration e scope.

Marcação da Configuração:

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

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

   <!ELEMENT activeKeyConfiguration EMPTY>

   Este elemento é utilizado para definir a configuração de teclas inicialmente ativa para Eclipse. Se houver mais de um desses elementos, apenas o último elemento declarado (na ordem de leitura do registro de plug-in) será considerado válido.

   <!ATTLIST activeKeyConfiguration
     value CDATA #IMPLIED
   >

   <!ELEMENT category EMPTY>

   Na UI, os comandos são normalmente organizados por categoria para facilitar o gerenciamento. Este elemento é utilizado para definir essas categorias. Os comandos podem se auto-incluir em, no máximo, uma categoria. Se houver mais de um desses elementos com o mesmo atributo id, apenas o último elemento declarado (na ordem de leitura do registro de plug-in) será considerado válido.

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

   <!ELEMENT command EMPTY>

   Este elemento é utilizado para definir comandos. Um comando representa um pedido do usuário que pode ser identificado por uma ação e que deve ser semanticamente exclusivo dentre outros comandos. Não defina um comando se já houver outro definido com o mesmo significado. Se houver mais de um desses elementos com o mesmo atributo id, apenas o último elemento declarado (na ordem de leitura do registro de plug-in) será considerado válido. Consulte os pontos de extensão org.eclipse.ui.actionSets e org.eclipse.ui.editorActions para compreender como as ações estão conectadas aos comandos.

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

   <!ELEMENT keyBinding EMPTY>

   Este elemento permite a atribuição de seqüências de teclas para comandos.

   <!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 é utilizado para definir configurações de teclas. Se houver mais de um desses elementos com o mesmo atributo id, apenas o último elemento declarado (na ordem de leitura do registro de plug-in) será considerado válido.

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

   <!ELEMENT scope EMPTY>

   Este elemento é utilizado para definir escopos. Se houver mais de um desses elementos com o mesmo atributo id, apenas o último elemento declarado (na ordem de leitura do registro de plug-in) será considerado válido.

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

O arquivo plugin.xml no plug-in org.eclipse.ui torna extensivo o uso do ponto de extensão org.eclipse.ui.commands.

Informações de API:

Esta não é nenhuma API pública para a declaração de comandos, categorias, ligações de teclas, configurações de teclas ou escopos diferentes deste ponto de extensão. A API pública para consultas e para a definição de escopos, bem como para o registro de ações para a identificação de comandos específicos pode ser encontrada em org.eclipse.ui.IKeyBindingService.

Copyright (c) 2000, 2003 IBM Corporation e outros.
Todos os direitos reservados. Este programa e os materiais que o acompanham são disponibilizados sob os termos da Common Public License v1.0 que acompanha esta distribuição e estão disponíveis no endereço http://www.eclipse.org/legal/cpl-v10.html