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>
support
, será escolhido o elemento cujo valor productId
corresponda ao id de produto activo.<!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
.
org.eclipse.help.ILiveHelpAction
. Esta classe será utilizada quando a mensagem do documento contiver uma hiperligação ou um botão cujo valor href
contenha uma cadeia de substituição ACTIVITY_EDITOR. A classe deve ser implementada de forma a invocar e mostrar programaticamente um componente de UI (por exemplo, uma página de preferências), facultado pelo produto, para alterar o estado de activação das 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. <p> Para activar a tarefa, abra a <a href="ACTIVITY_EDITOR">Página de Preferências da Tarefa.</a></documentMessage>
</support>
</extension>
class
do elemento documentMessage
tem de implementar a interface org.eclipse.help.ILiveHelpAction
.
Copyright (c) 2005 IBM Corporation e outros.
Todos os direitos reservados. Este programa e os materiais que o acompanham estão disponíveis sob os termos da Eclipse Public License v1.0, que acompanha esta distribuição, e estão disponíveis em http://www.eclipse.org/legal/epl-v10.html