Extensión de elementos de hoja de apuntes
Identificador:
org.eclipse.ui.cheatsheets.cheatSheetItemExtension
A partir del release:
3.0
Descripción:
Este punto de extensión debe utilizarse cuando sea necesario añadir un botón a un paso de la hoja de apuntes.
Puede colocar un atributo nuevo en el código "item" del archivo de contenido de hoja de apuntes para que, cuando la infraestructura de la hoja de apuntes lea el valor, compruebe si existe una clase registrada mediante este punto de extensión que maneje este atributo. El nombre de atributo encontrado en el archivo de contenido de hoja de apuntes se comparará con todos los valores encontrados en el atributo "itemAttribute" de todas las implementaciones del punto cheatsheetItemExtension registradas. Si existe una coincidencia, la infraestructura de hoja de apuntes cargará la clase especificada para manejar este atributo de elemento y se llamará a la clase para que maneje el atributo especificado en el archivo de contenido de hoja de apuntes.
Después de haber analizado el valor del atributo de elemento, la clase permanecerá disponible para la infraestructura de hoja de apuntes. Cuando el elemento se visualice en la vista de hojas de apuntes, se llamará de nuevo a la clase para que maneje la adición de componentes a un Compuesto. Los elementos añadidos al compuesto se visualizan en el paso de la hoja de apuntes (actualmente, junto al icono de ayuda). Sólo se visualizan para el paso descrito por el código "item" que el atributo muestra en el archivo de contenido de hoja de apuntes.
la utilización sugerida de este punto de extensión consiste en añadir un pequeño botón
(16x16) con un gráfico que abre un recuadro de diálogo al pulsarlo.
Código de configuración:
<!ELEMENT extension (itemExtension)*>
<!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 itemExtension EMPTY>
<!ATTLIST itemExtension
itemAttribute CDATA #REQUIRED
class CDATA #REQUIRED>
Utilice esta extensión de elementos para añadir elementos a los pasos de la hoja de apuntes. Puede utilizar este punto de extensión para añadir iconos y botones (actualmente, junto al icono de ayuda) para un paso de la hoja de apuntes.
Debe especificar el nombre de un atributo que va a colocar en el código item de la hoja de apuntes. También especificará una clase que manejará el análisis del valor de atributo del archivo de contenido de hoja de apuntes cuando se cargue la hoja de apuntes. El valor de atributo debe ser de tipo serie. La clase especificada debe crear una subclase de
org.eclipse.ui.cheatsheets.AbstractItemExtensionElement
. Una vez analizado y cargado el archivo de contenido de hoja de apuntes, se llama de nuevo a la clase especificada en el punto de extensión mediante la interfaz para añadir gráficos o botones al paso de la hoja de apuntes (actualmente, junto al botón de ayuda).
- itemAttribute: este valor de atributo debe ser el valor de tipo serie de un nombre de atributo que se coloca en un código item del archivo de contenido de hoja de apuntes. Si la serie de atributo coincide con un atributo analizado desde el código item del archivo de contenido de hoja de apuntes, la clase especificada se cargará e invocará para analizar el valor completo del atributo mediante la especificación w3 DOM. Más tarde, se invocará para añadir controles a un Compuesto y los componentes añadidos (generalmente gráficos o botones) aparecerán en el paso de la hoja de apuntes correspondiente el elemento especificado (actualmente, junto el icono de ayuda de ese paso).
- class: nombre de clase totalmente calificado de la clase que crea
una subclase de
org.eclipse.ui.cheatsheets.AbstractItemExtensionElement
para
manejar atributos desconocidos del archivo de contenido de hoja de apuntes y
ampliar los pasos de la hoja de apuntes. La clase debe ser pública y tener un constructor público de 1 argumento que acepte el nombre de atributo (tipo String
).
Ejemplos:
A continuación figura un ejemplo de implementación de este punto de extensión:
<extension point=
"org.eclipse.ui.cheatsheets.cheatSheetItemExtension"
>
<itemExtension
itemAttribute=
"xyzButton"
class=
"com.example.HandleParsingAndAddButton"
>
</itemExtension>
</extension>
Y a continuación figura el atributo de elemento de la extensión:
<item title=
"XYZ Title"
xyzButton=
"/icon/button.gif"
/>
Tenga en cuenta que el valor del atributo del código item puede ser ANYTHING. Puede ser
anything debido a que la clase que analiza dicho atributo es la clase
HandleParsingAndAddButton, que en este ejemplo analiza una serie /icon/button.gif del atributo. Posteriormente, la clase utilizará esa información para cargar el gif y utilizarlo como icono de un botón nuevo.
Información sobre las API:
Consulte la información del Javadoc correspondiente a org.eclipse.ui.cheatsheets.AbstractItemExtensionElement para obtener detalles acerca de la API.
Implementación suministrada:
Actualmente no se suministra ninguna implementación.
Copyright (c) 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