Extensões da Perspectiva
Identificador:
org.eclipse.ui.perspectiveExtensions
Descrição:
Esse ponto de extensão é utilizado para estender perspectivas
registradas por outros plug-ins. Uma perspectiva define o conteúdo inicial de barras de ações da janela (menu e barra de ferramentas) e o conjunto inicial de exibições e layouts em uma página do workbench.
Outros plug-ins podem contribuir para a perspectiva com ações ou exibições que aparecem quando a perspectiva é selecionada. Inclusões opcionais por outros plug-ins são anexadas à definição inicial.
Marcação de Configuração:
<!ELEMENT extension (perspectiveExtension*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - um identificador completo do ponto de extensão de destino
- id - um identificador opcional da instância de extensão
- name - um nome opcional da instância de extensão
<!ELEMENT perspectiveExtension (actionSet | viewShortcut | perspectiveShortcut | newWizardShortcut | view | showInPart)*>
<!ATTLIST perspectiveExtension
targetID CDATA #REQUIRED>
- targetID - identificador único da perspectiva (conforme especificado no registro) dentro do qual a contribuição é feita.
<!ELEMENT actionSet EMPTY>
<!ATTLIST actionSet
id CDATA #REQUIRED>
- id - identificador único do conjunto de ações que será incluído à perspectiva.
<!ELEMENT viewShortcut EMPTY>
<!ATTLIST viewShortcut
id CDATA #REQUIRED>
- id - o identificador exclusivo da exibição que será incluído na perspectiva do submenu "Mostrar Visualização" do menu "Janela".
<!ELEMENT perspectiveShortcut EMPTY>
<!ATTLIST perspectiveShortcut
id CDATA #REQUIRED>
- id - o identificador exclusivo da perspectiva que será incluído na
perspectiva do submenu "Abrir Perspectiva" do menu "Janela".
<!ELEMENT newWizardShortcut EMPTY>
<!ATTLIST newWizardShortcut
id CDATA #REQUIRED>
- id - o identificador exclusivo do novo assistente que será incluído na
perspectiva do submenu "Novo" do menu "Arquivo".
<!ELEMENT showInPart EMPTY>
<!ATTLIST showInPart
id CDATA #IMPLIED>
- id - o identificador exclusivo da exibição que será incluído no prompt "Mostrar em..." da perspectiva, no menu Navegar.
<!ELEMENT view EMPTY>
<!ATTLIST view
id CDATA #REQUIRED
relative CDATA #IMPLIED
relationship (stack|left|right|top|bottom|fast)
ratio CDATA #IMPLIED
visible (true | false)
closeable (true | false)
moveable (true | false)
standalone (true | false)
showTitle (true | false) >
- id - o identificador único da exibição que será incluído ao layout da perspectiva.
- relative - o identificador exclusivo de uma exibição que já existe na perspectiva. Será utilizado como ponto de referência para o posicionamento da exibição. O relacionamento entre essas duas exibições é definido por relationship. Ignorado se o relacionamento for "fast".
- relationship - especifica o relacionamento entre id e relative.
Os seguintes valores são suportados:
fast - a extensão de exibição será criada como a exibição rápida.
stack - a extensão da exibição será empilhada com a exibição relativa em uma pasta.
left, right, top, bottom - a extensão da exibição será posicionada ao lado da exibição relativa. Nesse caso, ratio também deverá ser definido.
- ratio - a porcentagem da área dentro da exibição relativa que será
doada à extensão da exibição. Se a extensão de exibição for uma exibição rápida,
a proporção será a porcentagem do workbench que a exibição rápida abrangerá quando
ativa. Esta deve ser definida como um valor do ponto flutuante e se encontra entre
0,05 e 0,95.
- visible - se a exibição ficar inicialmente visível quando a perspectiva for
aberta. Esse atributo deverá ter um valor "true" ou "false", se utilizado.
Se esse atributo não for utilizado, a exibição ficará inicialmente visível por padrão.
- closeable - se a exibição será fechável ou não na perspectiva de destino. Esse atributo deverá ter um valor "true" ou "false", se utilizado.
Se esse atributo não for utilizado, a exibição será fechável, a menos que a própria perspectiva seja marcada como fixa.
- moveable - se a exibição será movível. Uma exibição não movível não pode ser movida dentro da mesma pasta ou movida entre pastas na perspectiva. Esse atributo deverá ter um valor "true" ou "false", se utilizado.
Se esse atributo não for utilizado, a exibição será movível, a menos que a própria perspectiva seja marcada como fixa.
- standalone - se a exibição for autônoma. Uma exibição autônoma não pode ser acoplada a outras exibições na mesma pasta. Esse atributo deverá ter um valor "true" ou "false", se utilizado.
Ele será ignorado se o atributo do relacionamento for "fast" ou "stacked". Se esse atributo não for utilizado, a exibição será uma exibição normal e não uma exibição autônoma (o padrão é "false").
- showTitle - se o título da exibição será mostrado ou não. Esse atributo deverá ter um valor "true" ou "false", se utilizado.
Ele se aplica apenas a exibições autônomas. Se esse atributo não for utilizado, o título da exibição será mostrado (o padrão é "true").
Exemplos:
A seguir um exemplo da extensão da perspectiva (note os sub-elementos e o modo como os atributos são utilizados):
<extension point=
"org.eclipse.ui.perspectiveExtensions"
>
<perspectiveExtension
targetID=
"org.eclipse.ui.resourcePerspective"
>
<actionSet id=
"org.eclipse.jdt.ui.JavaActionSet"
/>
<viewShortcut id=
"org.eclipse.jdt.ui.PackageExplorer"
/>
<newWizardShortcut id=
"org.eclipse.jdt.ui.wizards.NewProjectCreationWizard"
/>
<perspectiveShortcut id=
"org.eclipse.jdt.ui.JavaPerspective"
/>
<view id=
"org.eclipse.jdt.ui.PackageExplorer"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"pilha"
/>
<view id=
"org.eclipse.jdt.ui.TypeHierarchy"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"left"
ratio=
"0.50"
/>
</perspectiveExtension>
</extension>
No exemplo acima, um conjunto de ações, atalhos de exibição e novos atalhos de assistente e de perspectiva contribuem com o conteúdo inicial da Perspectiva do Recurso. Além disso, a exibição Explorador de Pacotes é empilhada na exibição Navegador de Recursos e a exibição Hierarquia de Tipo é incluída ao lado da exibição Navegador de Recursos.
Informações sobre API:
Os itens definidos na extensão de perspectivas contribuem com o conteúdo inicial da perspectiva de destino. Desse modo, o usuário pode remover qualquer contribuição ou incluir outras à perspectiva a partir da interface com o usuário do workbench.
Direitos Autorais (c) 2002, 2004 IBM Corporation e outros.
Todos os direitos reservados.
Este programa e os materiais que o acompanham são disponibilizados
sob os termos da Eclipse Public License v1.0 que acompanha esta
distribuição e estão disponíveis no endereço http://www.eclipse.org/legal/epl-v10.html