Conjuntos de Aceleradores

Identificador: org.eclipse.ui.acceleratorSets

Desde: Release 2.0

Descrição:

AVISO: Este ponto de extensão foi SUBSTITUÍDO.
Não utilize esse ponto de extensão, ele será removido em versões futuras deste produto. Utilize o ponto de extensão org.eclipse.ui.commands

Esse ponto de extensão é utilizado para registrar extensões do conjunto de aceleradores. Os conjuntos de aceleradores significam apenas o que o nome implica, conjuntos de aceleradores. Um acelerador é uma associação entre uma ou mais seqüências de teclas de aceleração e uma ação do workbench. Uma seqüência de teclas de aceleração pode ter o comprimento um ou maior.

Um conjunto de aceleradores é registrado com a configuração de um acelerador (consulte o ponto de extensão Configuração do Acelerador) e é aplicável a um escopo do acelerador (consulte o ponto de extensão Escopo do Acelerador).

Marcação da Configuração:

   <!ELEMENT extension (acceleratorSet*)>

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

   <!ELEMENT acceleratorSet (accelerator+)>

   <!ATTLIST acceleratorSet
     configurationId CDATA #REQUIRED
     scopeId         CDATA #REQUIRED
   >

   <!ELEMENT accelerator EMPTY>

   <!ATTLIST accelerator
     id       CDATA #IMPLIED
     key      CDATA #REQUIRED
     locale   CDATA #IMPLIED
     platform CDATA #IMPLIED
   >

Exemplos: A seguir, um exemplo de extensão de um conjunto de aceleradores:

   <extension point="org.eclipse.ui.acceleratorSets"> 
      <acceleratorSet 
        configurationId="org.eclipse.ui.exampleAcceleratorConfiguration" 
        scopeId="org.eclipse.ui.globalScope"> 
          <accelerator 
              id="org.eclipse.ui.ExampleActionA" 
              key="CTRL+R CTRL+A"> 
          </accelerator> 
          <accelerator 
              id="org.eclipse.ui.ExampleActionB" 
              key="CTRL+R CTRL+B"> 
          </accelerator> 
          <accelerator 
              id="org.eclipse.ui.ExampleActionC" 
              key="CTRL+R CTRL+C || CTRL+SHIFT+DELETE"> 
          </accelerator> 
      </acceleratorSet> 
   </extension> 

Informações de API: Mais de um acelerador pode ser especificado para a mesma ação no conjunto de aceleradores, mas apenas um será utilizado.

Se o locale e/ou a plataforma for especificada, o acelerador que melhor corresponde ao locale e à plataforma atuais será utilizado. O locale atual é determinado pela API Locale.getDefault() e a plataforma pela API SWT.getPlatform(). Se a plataforma e/ou o locale forem especificados e não corresponderem ao locale e/ou plataforma atuais, o acelerador será descartado. Se o acelerador A definir apenas o locale e B definir apenas a plataforma, B será utilizado. Se o acelerador A definir "ja" como seu locale e B definir "ja_JP", B será utilizado no caso do locale atual ser "ja_JP".

Se dois aceleradores forem definidos em conjuntos de aceleradores em plug-ins diferentes, o acelerador escolhido irá depender dos plug-ins. Se o plug-in A depender de B, os aceleradores definidos em B serão utilizados. Se A e B não dependerem um do outro, eles serão alfabeticamente ordenados pelo ID do plug-in.

Se dois aceleradores forem definidos em escopos diferentes, o acelerador definido no escopo atual será utilizado. Se um acelerador não for definido no escopo atual ou em um de seus pais, ele será descartado. Se um acelerador for definido em um escopo pai e filho, aquele no filho será utilizado.

Implementação Fornecida: O workbench fornece conjuntos de aceleradores para as configurações do acelerador Padrão e Emacs.

Copyright (c) 2002 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