Contributos de menu de área de trabalho

Já vimos vários pontos de extensão diferentes que contribuem para diversos menus e barras de ferramentas na área de trabalho. Como sabemos qual utilizar? A tabela seguinte resume os diversos contributos de menu e respectiva utilização.

Nome do ponto de extensão

Localização das Acções

Detalhes

viewActions

As acções aparecem na barra de ferramentas local e no menu pendente local de uma vista específica.

Contribua com uma classe de acções que implemente IViewActionDelegate. Especifique o ID do contributo e o ID da vista destino que deverá mostrar a acção. A etiqueta e a imagem ditam a aparência da acção na UI. O caminho especifica a localização relativamente aos artigos de menu e barra de ferramentas da vista.

editorActions

As acções são associadas a um editor e aparecem no menu e/ou na barra de ferramentas da área de trabalho.

Contribua com uma classe de acções que implemente IEditorActionDelegate. Especifique o ID do contributo e o ID do editor destino que causa a mostra da acção. A etiqueta e a imagem especificam a aparência da acção na UI. Os caminhos de menu e barra de ferramentas separados especificam a existência e a localização do contributo no menu e na barra de ferramentas da área de trabalho.

popupMenus

As acções aparecem no menu emergente de um editor ou uma vista. As acções associadas a um tipo de objecto aparecem em todos os menus emergentes de vistas e editores que mostrem o tipo de objecto. As acções associadas a um menu emergente específico só aparecem nesse menu emergente.

Os contributos de objectos especificam o tipo de objecto para o qual a acção deve aparecer num menu emergente. a acção será mostrada em todos os menus emergentes de vistas e editores que contenham o tipo de objecto.  Indique uma classe de acções que implemente IObjectActionDelegate.  
Os contributos de visualizador especificam o ID do menu emergente destino no qual deve aparecer o artigo de menu.   Indique uma classe de acções que implemente IEditorActionDelegate ou IViewActionDelegate

actionSets

As acções aparecem nos menus e na barra de ferramentas principais da área de trabalho. As acções são agrupadas em conjuntos de acções. Todas as acções num conjunto de acções serão mostradas nos menus e na barra de ferramentas da área de trabalho, segundo a selecção do utilizador dos conjuntos de acções e da actual perspectiva mostrada na área de trabalho.  Poderá ser influenciado por actionSetPartAssociations (infra).

Indique uma classe de acções que implemente IWorkbenchWindowActionDelegate ou IWorkbenchWindowPulldownDelegate.Especifique nome e id do conjunto de acções. Enumere todas as acções que estão definidas nesse conjunto de acções. Para cada acção, caminhos de menu e barra de ferramentas separados especificam a existência e a localização do contributo no menu e na barra de ferramentas da área de trabalho.

actionSetPartAssociations

Os conjuntos de acções são mostrados somente quando as vistas ou os editores especificados estiverem activos.  Isto será ignorado se o utilizador tiver personalizado a actual perspectiva.

Especifique um conjunto de acções por id, seguido de uma ou mais partes (por id) que devam estar activas na actual perspectiva para poder mostrar o conjunto de acções.