Exibições
Identificador:
org.eclipse.ui.views
Descrição:
Esse ponto de extensão é utilizado para definir visualizações adicionais
para o workbench. Uma exibição é um componente visual
dentro de uma página do workbench. Ela é normalmente utilizada para
navegar em uma hierarquia de informações (como o espaço de trabalho),
abrir um editor ou exibir as propriedades para
o editor ativo. O usuário pode tornar visível uma visualização a
partir do menu Janela > Mostrar Visualização ou fechá-la a partir da
barra de título local da visualização.
A fim de reduzir a desordem visual em Mostrar Diálogo Visualização, as exibições devem ser agrupadas utilizando-se categorias.
Marcação da Configuração:
<!ELEMENT extension (category | view | stickyView)*>
<!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 category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - nome único que será utilizado para identificar essa categoria.
- name - um nome traduzível que será utilizado na UI para essa categoria.
- parentCategory - caminho opcional composto dos IDs das categorias separados por '/'. Isso permite a criação de uma hierarquia de categorias.
<!ELEMENT view (description?)>
<!ATTLIST view
id CDATA #REQUIRED
name CDATA #REQUIRED
category CDATA #IMPLIED
class CDATA #REQUIRED
icon CDATA #IMPLIED
fastViewWidthRatio CDATA #IMPLIED
allowMultiple (true | false) >
- id - nome único que será utilizado para identificar essa exibição.
- name - nome traduzível que será utilizado na UI para essa exibição.
- category - atributo opcional composto dos IDs de categoria separados
por '/'. Cada categoria referenciada deve ser declarada em um
elemento de categoria correspondente.
- class - um nome completo da classe que implementa
org.eclipse.ui.IViewPart. Uma prática comum é subclassificar org.eclipse.ui.part.ViewPart
a fim de herdar a funcionalidade padrão.
- icon - nome relativo do ícone que será associado à exibição.
- fastViewWidthRatio - a percentagem da largura do workbench que a exibição assumir
como uma exibição rápida ativa. Esta deve ser definida como um valor do ponto flutuante e se encontra entre
0,05 e 0,95.
Se nenhum valor for fornecido, uma proporção padrão será utilizada.
- allowMultiple - sinalizador que indica se essa visualização permite a criação de várias instâncias utilizando IWorkbenchPage.showView(String id, String secondaryId). O padrão é false.
<!ELEMENT descrição (#PCDATA)>
um subelemento opcional cujo corpo deve conter um texto fornecendo uma breve descrição da visualização.
<!ELEMENT stickyView EMPTY>
<!ATTLIST stickyView
id CDATA #REQUIRED
location (RIGHT|LEFT|TOP|BOTTOM)
closeable (true | false)
moveable (true | false) >
Uma visualização tolerante é aquela que aparecerá por padrão em todas as perspectivas de uma janela quando aberta. Seu posicionamento inicial é regido pelo atributo de local, mas nada a impede de ser movida ou fechada pelo usuário. A utilização desse elemento causará apenas a criação de um marcador para a visualização; ele não a mostrará. Observe que esse elemento deve ser utilizado com muito cuidado e só deve ser aplicado em visualizações que realmente tenham necessidade de estar ativas nas perspectivas.
Desde a 3.0
- id - o id da visualização que se tornará tolerante.
- location - atributo opcional que especifica o local da visualização tolerante em relação à área do editor. Se ausente, a visualização será acoplada à direita da área do editor.
- closeable - atributo opcional que especifica se a visualização deve permitir fechamento. Se ausente, ela permitirá fechamento.
- moveable - atributo opcional que especifica se a visualização deve permitir movimento. Se ausente, ela permitirá movimento.
Exemplos:
A seguir um exemplo do ponto de extensão:
<extension point=
"org.eclipse.ui.views"
>
<category
id=
"com.xyz.views.XYZviews"
name=
"XYZ"
/>
<view
id=
"com.xyz.views.XYZView"
name=
"Visualização XYZ"
category=
"com.xyz.views.XYZviews"
class=
"com.xyz.views.XYZView"
icon=
"icons/XYZ.gif"
/>
</extension>
A seguir, um exemplo de declaração de visualização tolerante:
<extension point=
"org.eclipse.ui.views"
>
<stickyView
id=
"com.xyz.views.XYZView"
/>
</extension>
Informações da API:
O valor do atributo class deve ser um
nome completo da classe Java que implementa
org.eclipse.ui.IViewPart. É uma prática
comum subclassificar org.eclipse.ui.part.ViewPart
ao desenvolver uma nova exibição.
Implementação Fornecida:
A
Plataforma Eclipse fornece várias visualizações padrão, incluindo
Navigator, Propriedades, Esboço e Tarefas. Do ponto de vista do usuário, essas exibições não são diferentes de nenhuma outra exibição fornecida pelos plug-ins. Todas as exibições podem ser mostradas a partir do submenu
"Mostrar Visualização" do menu "Janela".
A posição de uma exibição é persistente: é salva quando a exibição é fechada e restaurada quando a exibição é reaberta em uma única sessão. A posição também persiste entre as sessões do workbench.
Direitos Autorais (c) 2002, 2005 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