Vistas

org.eclipse.ui.views

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.

<!ELEMENT extension (category | view | stickyView)*>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT category EMPTY>

<!ATTLIST category

id             CDATA #REQUIRED

name           CDATA #REQUIRED

parentCategory CDATA #IMPLIED>


<!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) >


<!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



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>

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.

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.