Vistas
Identificador:
org.eclipse.ui.views
Descrição:
Este ponto de extensão é utilizado para definir as vistas adicionais para a área de trabalho. Uma vista é um componente visual dentro de uma página da área de trabalho. Normalmente é utilizada para navegar numa hierarquia de informações (como o espaço de trabalho), abrir um editor ou visualizar as propriedades para o editor activo. O utilizador pode tornar uma vista visível a partir do menu Window > Show View, ou encerrá-la a partir da barra de título local da vista.
Para reduzir a desordem visual na caixa de diálogo Show View, as vistas devem ser agrupadas utilizando as 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 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 category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - um nome exclusivo que será utilizado para identificar esta categoria
- name - um nome traduzível que será utilizado na UI para esta categoria
- parentCategory - um caminho opcional composto por IDs de categoria separados pelo carácter '/'. Isto 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 - um nome exclusivo que será utilizado para identificar esta vista
- name - um nome traduzível que será utilizado na UI para esta vista
- category - um atributo opcional que é composto pelos IDs de categoria separados pelo carácter '/'. Cada categoria referenciada deve estar declarada num elemento category correspondente.
- class - um nome totalmente qualificado da classe que implementa org.eclipse.ui.IViewPart. Uma prática comum é dividir org.eclipse.ui.part.ViewPart em subclasses, para herdar a funcionalidade predefinida.
- icon - um nome relativo do ícone que será associado à vista.
- fastViewWidthRatio - a percentagem da largura da área de trabalho que a vista irá ocupar como uma vista rápida activa.
Deve ser definido como um valor de vírgula flutuante e deve estar entre 0.05 e 0.95. Se não for fornecido nenhum valor, será utilizado o rácio predefinido.
- allowMultiple - sinalizador que indica se esta vista permite a criação de instâncias múltiplas utilizando IWorkbenchPage.showView(String id, String secondaryId). O valor predefinido é "false".
<!ELEMENT description (#PCDATA)>
um subelemento opcional cujo corpo contém texto que fornece uma breve descrição da vista.
<!ELEMENT stickyView EMPTY>
<!ATTLIST stickyView
id CDATA #REQUIRED
location (RIGHT|LEFT|TOP|BOTTOM)
closeable (true | false)
moveable (true | false) >
Uma vista fixa é uma vista que irá aparecer por predefinição em todas as perspectivas numa janela assim que for aberta. A respectiva colocação inicial é controlada pelo atributo location, mas nada impede que seja movida ou encerrada pelo utilizador. O uso deste elemento irá apenas causar a criação de um espaço reservado para a vista, não irá mostrar a vista. Note que a utilização deste elemento deve fazer-se com grande cuidado e deve ser aplicado apenas a vistas que necessitem realmente de existir em todas as perspectivas.
Desde 3.0
- id - o id da vista que deve converter-se em fixa.
- location - atributo opcional que especifica a localização da vista fixa relativa à área do editor. Se estiver ausente, a vista será colocada à direita da área do editor.
- closeable - atributo opcional que especifica se a vista deve ser passível de ser encerrada. Se estiver ausente, a vista será passível de ser encerrada.
- moveable - atributo opcional que especifica se a vista deve ser deslocável. Se estiver ausente, a vista será deslocável.
Exemplos:
A seguir encontra-se 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=
"XYZ View"
category=
"com.xyz.views.XYZviews"
class=
"com.xyz.views.XYZView"
icon=
"icons/XYZ.gif"
/>
</extension>
A seguir encontra-se um exemplo de uma declaração de vista fixa:
<extension point=
"org.eclipse.ui.views"
>
<stickyView
id=
"com.xyz.views.XYZView"
/>
</extension>
Informações de API:
O valor do atributo class deve ser um nome totalmente qualificado da classe que implementa org.eclipse.ui.IViewPart. É uma prática comum dividir em subclasses org.eclipse.ui.part.ViewPart ao desenvolver uma nova vista.
Implementação Fornecida:
A plataforma Eclipse fornece várias vistas padrão incluindo Navegador, Propriedades, Esquema e Tarefas. Do ponto de vista do utilizador, estas vistas não são diferentes de qualquer outra vista fornecidas pelos conectores. Todas as vistas podem ser apresentados no submenu "Show View" no menu "Window". A posição da vista é consistente: é guardada quando a vista é encerrada, e é restaurada quando a vista é reaberta numa sessão única. A posição é também consistente entre sessões da área de trabalho.
Copyright (c) 2002, 2005 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