org.eclipse.ui.editorActions

Acabamos de ver como os editores podem contribuir com suas próprias ações para os menus e barra de ferramentas do ambiente de trabalho, quando tornam-se ativos.  O ponto de extensão org.eclipse.ui.editorActions permite que um plug-in inclua nos menus do ambiente de trabalho e a barra de ferramentas quando o editor de outro plug-in torna-se ativo.

No exemplo do leia-me, o plug-in utiliza o ponto de extensão editorActions para contribuir com ações adicionais para o menu de contribuição do editor do leia-me. A definição em nosso plugin.xml deve parecer bastante familiar no momento.

<extension
      point = "org.eclipse.ui.editorActions">
      <editorContribution
         id="org.eclipse.ui.examples.readmetool.ec1"
         targetID="org.eclipse.ui.examples.readmetool.ReadmeEditor">
	   <action id="org.eclipse.ui.examples.readmetool.ea1"
              label="%Editors.Action.label"
            toolbarPath="ReadmeEditor"
              icon="icons/obj16/editor.png"
              tooltip="%Editors.Action.tooltip"
            class="org.eclipse.ui.examples.readmetool.EditorActionDelegate"
              definitionId="org.eclipse.ui.examples.readmetool.ea1"
              /> 
      </editorContribution>
    </extension>

Semelhante a uma ação de exibição, a extensão deve especificar o targetID do editor para o qual está contribuindo com ações.  A própria ação é bastante semelhante a uma ação de exibição (id, label, icon, toolbarPath, ...), exceto que a classe especificada deve implementar IEditorActionDelegate e um definitionId pode ser especificado para vincular essa ação a um Comando especificado pela extensão org.eclipse.ui.commands, que é importante para ligações de tecla. Consulte Comandos.

Observe que o caminho de uma barra de menus não é especificado nessa marcação.  Portanto, a ação aparecerá na barra de ferramentas do ambiente de trabalho quando o editor estiver ativo, mas não na barra de menus do ambiente de trabalho.  (Consulte Caminhos de menu e da barra de ferramentas para obter uma discussão sobre caminhos de barra de ferramentas e de menu.)

Sem dúvida, quando o editor está ativo, vemos a ação do nosso editor na barra de ferramentas, ao lado da ações que foram contribuições do próprio editor.

A ação do editor aparece próxima a contribuições originais do editor na barra de ferramentas do ambiente de trabalho

A ferramenta Leia-me fornece EditorActionDelegate para implementar a ação.  Essa classe é muito semelhante à delegação da ação de exibição que vimos anteriormente.

public void run(IAction action) {
	MessageDialog.openInformation(editor.getSite().getShell(),
		MessageUtil.getString("Readme_Editor"),  
		MessageUtil.getString("Editor_Action_executed"));
}