Extensión de elementos de hoja de apuntes

org.eclipse.ui.cheatsheets.cheatSheetItemExtension

3.0

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.

<!ELEMENT extension (itemExtension)*>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


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



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.

Consulte la información del Javadoc correspondiente a org.eclipse.ui.cheatsheets.AbstractItemExtensionElement para obtener detalles acerca de la API.

Actualmente no se suministra ninguna implementación.