Vistas
Identificador:
org.eclipse.ui.views
Descripción:
Este punto de extensión permite definir vistas adicionales para el entorno de trabajo. Una vista es un componente visual de una página del entorno de trabajo. Se suele utilizar para navegar por una jerarquía de información (como por ejemplo el
área de trabajo), abrir un editor o visualizar propiedades del editor activo. El
usuario puede hacer visible una vista desde el menú Ventana > Mostrar vista o
cerrarla desde la barra de título local de vista.
Para reducir el desorden visual del diálogo Mostrar vista, las vistas
deben agruparse en categorías.
Código de configuración:
<!ELEMENT extension (category | view | stickyView)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point: identificador totalmente calificado del punto de extensión destino
- id: identificador opcional de la instancia de extensión
- name: nombre opcional de la instancia de extensión
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id: nombre exclusivo que se empleará para identificar esta categoría.
- name: nombre traducible que se utilizará en la UI para esta categoría.
- parentCategory: vía de acceso opcional compuesta por los ID de las
categorías separados por una barra inclinada, '/'. Esto permite la creación de
una jerarquía de categorías.
<!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: nombre exclusivo que se empleará para identificar esta vista.
- name: nombre traducible que se utilizará en la UI para esta vista.
- category: atributo opcional compuesto por los ID de
las categorías separados por una barra inclinada, '/'. Cada categoría a la que
se hace referencia debe declararse en un elemento de categoría correspondiente.
- class: nombre totalmente calificado de la clase que implementa
org.eclipse.ui.IViewPart. Una práctica habitual consiste en crear una
subclase de org.eclipse.ui.part.ViewPart para que herede la
funcionalidad por omisión.
- icon: nombre relativo del icono que se asociará a la vista.
- fastViewWidthRatio: porcentaje de la anchura del entorno de trabajo que
la vista ocupará en forma de vista rápida activa.
Debe definirse como valor de punto flotante y
estar comprendido entre 0.05 y 0.95.
Si no se suministra ningún valor, se
empleará un valor de ratio por omisión.
- allowMultiple: distintivo que indica si esta vista permite la creación de varias instancias mediante IWorkbenchPage.showView(String id, String secondaryId). El valor por omisión es false.
<!ELEMENT description (#PCDATA)>
subelemento opcional cuyo cuerpo debe contener un texto
descriptivo corto de la vista.
<!ELEMENT stickyView EMPTY>
<!ATTLIST stickyView
id CDATA #REQUIRED
location (RIGHT|LEFT|TOP|BOTTOM)
closeable (true | false)
moveable (true | false) >
Una vista fija es aquella que aparecerá por omisión en todas las perspectivas de una ventana una vez abierta. Si ubicación inicial está controlada por el atributo location, pero nada impide que el usuario la mueva o la cierre. La utilización de este elemento sólo provocará la creación de un espacio reservado para la vista, pero no la mostrará. Tenga en cuenta que este elemento debe utilizarse con mucho cuidado y sólo debe aplicarse a las vistas que realmente necesiten persistir de una perspectiva a otra.
A partir del release 3.0
- id: ID de la vista que debe convertirse en fija.
- location: atributo opcional que especifica la ubicación de la vista fija en relación al área del editor. Si está ausente, la vista quedará acoplada a la derecha del área del editor.
- closeable: atributo opcional que especifica si la vista debe poder cerrarse. Si está ausente, la vista podrá cerrarse.
- moveable: atributo opcional que especifica si la vista debe poder moverse. Si está ausente, la vista podrá moverse.
Ejemplos:
A continuación figura un ejemplo de utilización del punto de extensión:
<extension point=
"org.eclipse.ui.views"
>
<category
id=
"com.xyz.views.XYZviews"
name=
"XYZ"
/>
<view
id=
"com.xyz.views.XYZView"
name=
"Vista XYZ"
category=
"com.xyz.views.XYZviews"
class=
"com.xyz.views.XYZView"
icon=
"icons/XYZ.gif"
/>
</extension>
A continuación figura un ejemplo de una declaración de vista fija:
<extension point=
"org.eclipse.ui.views"
>
<stickyView
id=
"com.xyz.views.XYZView"
/>
</extension>
Información sobre las API:
El valor del atributo
class debe ser un nombre totalmente calificado de una clase que implemente
org.eclipse.ui.IViewPart. Es una práctica común crear una subclase de
org.eclipse.ui.ViewPart al desarrollar una vista nueva.
Implementación suministrada:
La
plataforma Eclipse proporciona varias vistas estándar, entre ellas las de
Navegador, Propiedades, Esquema y Tareas. Desde el punto de vista del usuario, estas vistas no se distinguen de
ninguna otra proporcionada por los conectores. Todas las vistas se pueden
mostrar desde el submenú "Mostrar vista" del menú "Ventana". La posición de una
vista es persistente: se guarda al cerrar la vista y se restaura al abrirla
nuevamente en una sesión individual. La posición también persiste entre
las sesiones del entorno de trabajo.
Copyright (c) 2002, 2005 IBM Corporation y otros.
Reservados todos los derechos. Este programa y sus materiales adjuntos están
disponibles bajo los términos de la licencia pública común (Eclipse Public
License) v1.0 que acompaña a esta distribución, y está disponible en
http://www.eclipse.org/legal/epl-v10.html