Suporte de Actividades

org.eclipse.help.base.activitySupport

3.1

Este ponto de extensão é utilizado por plug-ins de produto para configurar o comportamento do sistema de Ajuda quando se utilizem actividades.É facultado para configurar os seguintes aspectos:

Este ponto de extensão é experimental e é provável que mude nas edições futuras, à medida que o suporte de actividade evoluir.

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

uma mensagem de texto simples que será mostrada na caixa de diálogo quando se desactivar o filtro de actividades. A mensagem destina-se a avisar que sem o filtro alguns documentos poderão fazer referência a elementos da interface do utilizador que não estão visíveis.



<!ELEMENT localScopeCheckbox (#PCDATA)>

uma etiqueta da caixa de verificação na página de preferências de âmbito de pesquisa local. Quando se selecciona a caixa de verificação, os acertos da pesquisa em documentos que pertencem a actividades desactivadas serão incluídos nos resultados da pesquisa.



<!ELEMENT documentMessage EMPTY>

<!ATTLIST documentMessage

class    CDATA #IMPLIED

pluginId CDATA #REQUIRED>

um fragmento HTML que será inserido no início do tópico de ajuda que pertence à actividade desactivada. A mensagem destina-se a notificar o utilizador de que o tópico pode conter referências aos elementos da UI que não estão visíveis. Dado que o texto da mensagem se encontra num ficheiro XML, os identificadores HTML têm de ser abandonados, utilizando entidades XML para caracteres especiais.

A mensagem pode conter uma hiperligação através da qual o utilizador acede ao editor de actividades, que se encarrega de estado de activação das actividades. Neste caso, deve ser utilizado o atributo class.



De seguida é apresentado um exemplo de utilização do ponto de extensão de suporte de actividades:

 

<extension point=

"org.eclipse.help.base.activitySupport"

>

<support productId=

"com.example.xyzProduct"

>

<showAllMessage>

Estas acções irão revelar todos os tópicos do índice.

</showAllMessage>

<documentMessage class=

"com.example.xyz.OpenRolePreference"

>

Este tópico pertence à tarefa que está actualmente desactivada. &lt;p&gt; Para activar a tarefa, abra a &lt;a href="ACTIVITY_EDITOR"&gt;Página de Preferências da Tarefa.&lt;/a&gt;

</documentMessage>

</support>

</extension>

O atributo class do elemento documentMessage tem de implementar a interface org.eclipse.help.ILiveHelpAction.

SDK de Eclipse faculta o suporte de actividades predefinido que utiliza o termo 'capacidade' e abre a página de preferências Capacidades, na hiperligação dos tópicos desactivados. Ao sobrepor, certifique-se de que as alterações e a terminologia correspondem às da UI de plataforma.