Extensiones de perspectivas
Identificador:
org.eclipse.ui.perspectiveExtensions
Descripción:
Este punto de extensión sirve para ampliar
las perspectivas registradas por otros conectores. Una perspectiva define el
contenido inicial de las barras de acciones (de menús y herramientas) de una
ventana y el conjunto inicial de vistas y su diseño dentro de una página del
entorno de trabajo.
Otros conectores pueden suministrar a
la perspectiva acciones o vistas, que aparecerán cuando se seleccione la perspectiva. Las adiciones opcionales de otros conectores se añaden a la definición inicial.
Código de configuración:
<!ELEMENT extension (perspectiveExtension*)>
<!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 perspectiveExtension (actionSet | viewShortcut | perspectiveShortcut | newWizardShortcut | view | showInPart)*>
<!ATTLIST perspectiveExtension
targetID CDATA #REQUIRED>
- targetID: identificador exclusivo de la perspectiva (tal como se
especifica en el registro) en la que se efectúa la contribución.
<!ELEMENT actionSet EMPTY>
<!ATTLIST actionSet
id CDATA #REQUIRED>
- id: identificador exclusivo del conjunto de acciones que se añadirá a la
perspectiva.
<!ELEMENT viewShortcut EMPTY>
<!ATTLIST viewShortcut
id CDATA #REQUIRED>
- id: identificador exclusivo de la vista que se añadirá al submenú
"Mostrar vista" del menú "Ventana" de la perspectiva.
<!ELEMENT perspectiveShortcut EMPTY>
<!ATTLIST perspectiveShortcut
id CDATA #REQUIRED>
- id: identificador exclusivo de la perspectiva que se añadirá al submenú
"Abrir perspectiva" del menú "Ventana" de la perspectiva.
<!ELEMENT newWizardShortcut EMPTY>
<!ATTLIST newWizardShortcut
id CDATA #REQUIRED>
- id: identificador exclusivo del asistente nuevo que se añadirá al submenú "Nuevo"
del menú "Archivo" de la perspectiva.
<!ELEMENT showInPart EMPTY>
<!ATTLIST showInPart
id CDATA #IMPLIED>
- id: identificador exclusivo de la vista que se añadirá a la
solicitud "Mostrar en..." en el menú Navegar de la perspectiva.
<!ELEMENT view EMPTY>
<!ATTLIST view
id CDATA #REQUIRED
relative CDATA #IMPLIED
relationship (stack|left|right|top|bottom|fast)
ratio CDATA #IMPLIED
visible (true | false)
closeable (true | false)
moveable (true | false)
standalone (true | false)
showTitle (true | false) >
- id: identificador exclusivo de la vista que se añadirá al diseño de la
perspectiva.
- relative: identificador exclusivo de una vista que ya existe en la perspectiva. Se utilizará como punto de referencia para la situación de la vista. La relación entre estas dos vistas se define en relationship. Se
ignora si la relación es "fast".
- relationship: especifica las relaciones entre id y
relative.
Los valores soportados son los siguientes:
fast: la extensión de la vista se creará en forma de vista rápida.
stack: la extensión de la vista se apilará en una carpeta junto con
la vista relativa.
left, right, top, bottom: la extensión de la vista se situará junto
a la vista relativa. En este caso, deberá definirse también un atributo
ratio.
- ratio: porcentaje del área dentro de la vista relativa que será donada a
la extensión de la vista. Si la extensión es una vista rápida, el atributo
ratio representa el porcentaje del entorno de trabajo que la vista rápida
cubrirá cuando esté activa. Debe definirse como valor de punto flotante y
estar comprendido entre 0.05 y 0.95.
- visible: indica si la vista estará visible inicialmente al abrir la
perspectiva. Si se utiliza este atributo, su valor debe ser "true" o
"false".
Si no se utiliza, la vista estará inicialmente visible por omisión.
- closeable: indica si la vista puede cerrarse en la perspectiva destino. Si se utiliza este atributo, su valor debe ser "true" o
"false". Si no se utiliza este atributo, la vista podrá cerrarse, a menos que la propia perspectiva esté marcada como fija.
- moveable: indica si la vista puede moverse. Una vista que no pueda moverse no podrá hacerlo dentro de la misma carpeta ni entre las carpetas de la perspectiva. Si se utiliza este atributo, su valor debe ser "true" o
"false".
Si no se utiliza este atributo, la vista podrá moverse, a menos que la propia perspectiva esté marcada como fija.
- standalone: indica si la vista es autónoma. Una vista autónoma no puede acoplarse con otras en la misma carpeta. Si se utiliza este atributo, su valor debe ser "true" o
"false". Este atributo se pasa por alto si el atributo relationship es "fast" o "stacked". Si no se utiliza este atributo, la vista será regular, no autónoma (el valor por omisión es "false").
- showTitle: indica si se muestra el título de la vista. Si se utiliza este atributo, su valor debe ser "true" o
"false". Este atributo sólo se aplica a vistas autónomas. Si no se utiliza este atributo, se mostrará el título de la vista (el valor por omisión es "true").
Ejemplos:
A continuación figura un ejemplo de extensión de
perspectiva (observe los subelementos y la manera de utilizar los atributos):
<extension point=
"org.eclipse.ui.perspectiveExtensions"
>
<perspectiveExtension
targetID=
"org.eclipse.ui.resourcePerspective"
>
<actionSet id=
"org.eclipse.jdt.ui.JavaActionSet"
/>
<viewShortcut id=
"org.eclipse.jdt.ui.PackageExplorer"
/>
<newWizardShortcut id=
"org.eclipse.jdt.ui.wizards.NewProjectCreationWizard"
/>
<perspectiveShortcut id=
"org.eclipse.jdt.ui.JavaPerspective"
/>
<view id=
"org.eclipse.jdt.ui.PackageExplorer"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"stack"
/>
<view id=
"org.eclipse.jdt.ui.TypeHierarchy"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"left"
ratio=
"0.50"
/>
</perspectiveExtension>
</extension>
En el ejemplo anterior se proporciona al contenido inicial de la perspectiva
Recursos un conjunto de acciones, un acceso directo a las vistas, un acceso directo al
asistente nuevo y un acceso directo a la perspectiva. Además, la vista Explorador de
paquetes está apilada sobre la vista Navegador de recursos, y se añade la vista
Jerarquía de tipos junto a la vista Navegador de recursos.
Información sobre las API:
Los elementos definidos dentro de la
extensión de perspectiva son contribuciones realizadas al contenido inicial
de la perspectiva destino. Teniendo esto en cuenta, el usuario puede eliminar
cualquier contribución o añadir otras a una perspectiva desde dentro de la
interfaz de usuario del entorno de trabajo.
Copyright (c) 2002, 2004 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