Exibições

org.eclipse.ui.views

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.

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



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>

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.

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.