Extensões de Perspectiva
Identificador:
org.eclipse.ui.perspectiveExtensions
Descrição:
Este ponto de extensão é utilizado para expandir perspectivas registadas por outros conectores. Uma perspectiva define os conteúdos iniciais das barras de acção das janelas (menu e barra de ferramentas) e o conjunto inicial de vistas e o respectivo esquema dentro de uma página da área de trabalho.
Outros conectores podem efectuar contribuições de acções ou vistas para a perspectiva, que aparecem quando a perspectiva é seleccionada. As adições opcionais de outros conectores são anexadas à definição inicial.
Marcação da Configuração:
<!ELEMENT extension (perspectiveExtension*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - um identificador totalmente qualificado 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 - o identificador exclusivo da perspectiva (conforme o especificado no registo) na qual se efectua a colaboração.
<!ELEMENT actionSet EMPTY>
<!ATTLIST actionSet
id CDATA #REQUIRED>
- id - o identificador exclusivo do conjunto de acções que serão adicionadas à perspectiva.
<!ELEMENT viewShortcut EMPTY>
<!ATTLIST viewShortcut
id CDATA #REQUIRED>
- id - o identificador exclusivo da vista que será adicionada ao sub-menu "Show View" da perspectiva do menu "Window".
<!ELEMENT perspectiveShortcut EMPTY>
<!ATTLIST perspectiveShortcut
id CDATA #REQUIRED>
- id - o identificador exclusivo da perspectiva que será adicionada ao submenu "Open Perspective" do menu "Window".
<!ELEMENT newWizardShortcut EMPTY>
<!ATTLIST newWizardShortcut
id CDATA #REQUIRED>
- id - o identificador exclusivo do novo assistente que será adicionado ao submenu "New" da perspectiva no menu "File".
<!ELEMENT showInPart EMPTY>
<!ATTLIST showInPart
id CDATA #IMPLIED>
- id - o identificador exclusivo da vista que será adicionada ao motor de pedido de informações "Show in..." da perspectiva no menu "Navigate".
<!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 exclusivo da vista que será adicionada ao esquema da perspectiva.
- relative - o identificador exclusivo de uma vista que já existe na perspectiva. Será utilizado como um ponto de referência para a colocação da vista. A relação entre estas duas vistas é definida por relationship. Será ignorada se a relação for definida como "fast".
- relationship - especifica a relação entre id e relative.
São suportados os seguintes valores:
fast - a extensão da vista será criada como uma vista rápida.
stack - a extensão da vista será colocada numa pilha com a vista relativa numa pasta.
left, right, top, bottom - a extensão da vista será colocada ao lado da vista relativa. Neste caso deve também ser definido um valor ratio.
- ratio - a percentagem da área da vista relativa que será doada à extensão da vista. Se a extensão da vista for uma vista rápida, o rácio é a percentagem da área de trabalho que a vista rápida irá cobrir quando estiver activa. Deve ser definido como um valor de vírgula flutuante e deve estar entre 0.05 e 0.95.
- visible - indica se a vista é visível inicialmente quando a perspectiva é aberta. Este atributo deve ter um valor de "true" ou "false", se for utilizado.
Se o atributo não for utilizado, a vista será visível inicialmente, por predefinição.
- closeable - indica se a vista é passível de ser encerrada na perspectiva de destino. Este atributo deve ter um valor de "true" ou "false", se for utilizado.
Se o atributo não for utilizado, a vista será passível de ser encerrada, a não ser que a própria perspectiva esteja marcada como fixa.
- moveable - indica se uma vista é deslocável. Uma vista não deslocável não se pode mover dentro da mesma pasta, ou entre pastas diferentes na perspectiva. Este atributo deve ter um valor de "true" ou "false", se for utilizado.
Se o atributo não for utilizado, a vista será deslocável, a não ser que a própria perspectiva esteja marcada como fixa.
- standalone - indica se a vista é autónoma. Uma vista autónoma não pode ser colocada em conjunto com outras na mesma pasta. Este atributo deve ter um valor de "true" ou "false", se for utilizado.
Este atributo é ignorado se o atributo relationship estiver definido como "fast" ou "stacked". Se o atributo não for utilizado, a vista será normal, não será uma vista autónoma (o valor predefinido é "true").
- showTitle - indica se o título da vista é mostrado. Este atributo deve ter um valor de "true" ou "false", se for utilizado.
O atributo aplica-se apenas a vistas autónomas. Se o atributo não for utilizado, o título da vista será mostrado (o valor predefinido é "true").
Exemplos:
A seguir encontra-se um exemplo de uma extensão de perspectiva (repare nos sub-elementos e no 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=
"stack"
/>
<view id=
"org.eclipse.jdt.ui.TypeHierarchy"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"left"
ratio=
"0.50"
/>
</perspectiveExtension>
</extension>
No exemplo anterior, as contribuições efectuadas são um conjunto de acções, um atalho de vista, um atalho de novo assistente e um atalho de perspectiva, para o conteúdo inicial da perspectiva de recurso. Além disso, a vista Explorador de Pacotes é colocada numa pilha no Navegador de Recursos e a vista Hierarquia de Tipos é adicionada ao lado do Navegador de Recursos.
Informações de API:
Os artigos definidos dentro da extensão da perspectiva são uma colaboração para o conteúdo inicial da perspectiva de destino. A seguir, o utilizador poderá remover qualquer colaboração ou adicionar outras à perspectiva a partir da interface de utilizador da área de trabalho.
Copyright (c) 2002, 2004 IBM Corporation e outros.
Todos os direitos reservados. Este programa e os materiais que o acompanham estão disponíveis
sob os termos da Eclipse Public License v1.0 que acompanha
esta distribuição e está disponível em http://www.eclipse.org/legal/epl-v10.html