Produtor de Conteúdo de Ajuda

org.eclipse.help.contentProducer

3.0

Destina-se a facultar conteúdo de ajuda dinâmico, gerado no tempo de execução. Os produtores de conteúdo estão registados por plug-in e funcionam apenas no âmbito do plug-in. Para reutilizar um produtor de conteúdo noutro plug-in, o elemento binding deverá ser utilizado. Esta estratégia impede os plug-ins do conteúdo highjacking que produz para todos os plug-ins. Ao associar-se a um produtor de conteúdo, um plug-in dá permissão ao conteúdo do controlo que produz para todos os documentos no plug-in concedido.

<!ELEMENT extension (contentProducer | binding)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contentProducer (producer)>

<!ATTLIST contentProducer

producer CDATA #IMPLIED>


<!ELEMENT producer (parameter*)>

<!ATTLIST producer

class CDATA #REQUIRED>


<!ELEMENT parameter EMPTY>

<!ATTLIST parameter

name  CDATA #REQUIRED

value CDATA #REQUIRED>


<!ELEMENT binding EMPTY>

<!ATTLIST binding

producerId CDATA #REQUIRED>


De seguida é apresentado um exemplo do ponto de extensão do produtor de conteúdo:

  

<extension point=

"org.eclipse.help.contentProducer"

id=

"org.eclipse.myPlugin.myDynamicHelpProducer"

name=

"O Meu Conteúdo de Ajuda Dinâmico"

>

<contentProducer producer=

"org.eclipse.myPlugin.myPackage.Myproducer"

/>

</extension>

A classe do produtor de conteúdo facultada tem de implementar a interface org.eclipse.help.IHelpContentProducer. O produtor é responsável por facultar conteúdo aos recursos de ajuda dinâmicos de um plug-in. O método do produtor de conteúdos é chamado pela ajuda para cada recurso de ajuda obtido do plug-in.

Nenhuma. Caso um plug-in de documentação não faculte um produtor de conteúdo de ajuda ou caso uma chamada dos seus resultados seja nula, o sistema de ajuda pesquisa no ficheiro doc.zip e no sistema de ficheiros do local de instalação do plug-in um documento estático e apresenta o seu conteúdo.