Descrição: Define o auxílio dependente de contexto para um plug-in individual.
Marcação da Configuração:
<!ELEMENT extension (contexts*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED
>
<!ELEMENT contexts EMPTY>
<!ATTLIST contexts
file CDATA #REQUIRED
plugin CDATA #IMPLIED
>
Marcação de Configuração para informações contidas no arquivo manifest de contexto:
<!ELEMENT contexts (context)* ) >
<!ELEMENT context (description?,topic*) >
<!ATTLIST context id ID #REQUIRED >
<!ELEMENT description (#PCDATA)>
<!ELEMENT topic EMPTY >
<!ATTLIST topic label CDATA #REQUIRED >
<!ATTLIST topic href CDATA #IMPLIED >
Os arquivos manifest de contextos fornecem todas as informações necessárias quando um auxílio dependente de contexto é solicitado pelo usuário. O ID é transmitido pela plataforma para identificar o contexto atualmente ativo. As definições de contexto com IDs correspondentes são recuperadas. O objeto IContext é criado pelo sistema de ajuda que contém as descrições e os tópicos de todas as definições de contexto para um determinado ID. A descrição será exibida para o usuário e os tópicos relacionados poderão ser úteis para que o usuário entenda o contexto atual. Tópicos relacionados são arquivos html compactados em doc.zip, juntos com os tópicos que fazem parte da ajuda online.
Se um plug-in definir um id de contexto, o usuário poderá estender a descrição ou os links relacionados a um contexto declarando outro contexto com o mesmo id.
<extension point="org.eclipse.help.contexts"> <contexts file="xyzContexts.xml"/> </extension>
(no arquivo xyzContexts.xml)
<contexts>
<contexto id="generalContextId">
<descrição> Esta é uma </descrição> da amostra da cadeia de ajuda F1.
<topic href="contexts/RelatedContext1.html"
label="Help Related Topic 1"/>
<topic href="contexts/RelatedContext2.html"
label="Help Related Topic 2"/>
</context>
</contexts>
Os tópicos relacionados contidos em doc.zip podem ser localizados criando
um arquivo doc.zip com a versão traduzida de documentos e colocando o doc.zip
no diretório
nl/<idioma>/<país> ou nl/<idioma>. O sistema de ajuda
procurará os arquivos nestes diretórios antes de assumir como padrão
o diretório do plug-in.
Informações de API: Não é necessário nenhum código para utilizar esse ponto de extensão. É necessário apenas fornecer o(s) arquivo(s) manifest adequado(s), mencionado(s) no arquivo plugin.xml.
Implementação Fornecida: A implementação padrão opcional do sistema de ajuda da UI fornecido com a plataforma Eclipse suporta completamente o ponto de extensão contexts.
Copyright (c) 2000, 2003 IBM Corporation e outros.
Todos os direitos reservados.
Este programa e os materiais que o acompanham são disponibilizados sob os termos da Common Public License v1.0 que acompanha esta distribuição e estão disponíveis no endereço http://www.eclipse.org/legal/cpl-v10.html