Soporte de actividades

org.eclipse.help.base.activitySupport

3.1

Los conectores de producto utilizan este punto de extensión para configurar el comportamiento del sistema de Ayuda cuando se utilizan las actividades. Se proporciona para configurar los aspectos siguientes:

Este punto de extensión es experimental y es probable que cambie en releases futuros a medida que evolucione el soporte de actividades.

<!ELEMENT extension (support+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT support (localScopeCheckbox , documentMessage , showAllMessage)>

<!ATTLIST support

productId CDATA #REQUIRED>


<!ELEMENT showAllMessage (#PCDATA)>

mensaje de texto sin formato que se mostrará en el diálogo cuando se desactive el filtrado de actividades. El propósito del mensaje es el de advertir que, sin el filtro, es posible que algunos documentos hagan referencia a elementos de la interfaz de usuario que no son visibles.



<!ELEMENT localScopeCheckbox (#PCDATA)>

etiqueta del recuadro de selección en la página de preferencias de ámbito de búsqueda local. Cuando el recuadro de selección está seleccionado, las coincidencias de la búsqueda que pertenecen a actividades inhabilitadas se incluirán en los resultados de la búsqueda.



<!ELEMENT documentMessage EMPTY>

<!ATTLIST documentMessage

class    CDATA #IMPLIED

pluginId CDATA #REQUIRED>

fragmento de HTML que se inyectará al principio del tema de ayuda que pertenece a la actividad inhabilitada. El propósito del mensaje es el de notificar al usuario que es posible que el tema contenga referencias a elementos de la UI que no son visibles. Dado que el texto del mensaje se encuentra dentro de un archivo XML, debe escaparse de los códigos HTML utilizando entidades XML estándar para los caracteres especiales.

El mensaje puede contener un hiperenlace que lleve al usuario al editor de actividades, que se encarga de cambiar el estado de habilitación de actividades. En este caso debe utilizarse el atributo class.



A continuación se muestra un ejemplo de utilización del punto de extensión de soporte de actividades:

 

<extension point=

"org.eclipse.help.base.activitySupport"

>

<support productId=

"com.example.xyzProduct"

>

<showAllMessage>

Esta acción revelará todos los temas de la tabla de contenido.

</showAllMessage>

<documentMessage class=

"com.example.xyz.OpenRolePreference"

>

Este tema pertenece al rol que está inhabilitado actualmente. &lt;p&gt; Para habilitar el rol, abra &lt;a href="ACTIVITY_EDITOR"&gt;Página Preferencias de rol.&lt;/a&gt;

</documentMessage>

</support>

</extension>

El atributo class del elemento documentMessage debe implementar la interfaz org.eclipse.help.ILiveHelpAction.

SDK de Eclipse proporciona el soporte de actividades por omisión que utiliza el término 'prestación' y abre la página de preferencias de Prestaciones del hiperenlace en los temas inhabilitados. Al alterar temporalmente un valor, asegúrese de que los cambios y la terminología coincidan con los de la UI de plataforma.