Ajuda para Marcadores
Identificador:
org.eclipse.ui.ide.markerHelp
A partir de:
3.0 (originalmente adicionado na edição 2.0 como org.eclipse.ui.markerHelp)
Descrição:
Este ponto de extensão é utilizado para associar um ID de contexto da ajuda a um "tipo" específico de marcador (um marcador de um determinado tipo ou que tenha determinados valores de atributos).
Marcação da Configuração:
<!ELEMENT extension (markerHelp*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - um identificador totalmente qualificado do ponto de extensão de destino
- id - um identificador opcional da instância de extensão
- name - um nome opcional da instância de extensão
<!ELEMENT markerHelp (attribute*)>
<!ATTLIST markerHelp
markerType CDATA #IMPLIED
helpContextId CDATA #REQUIRED>
- markerType - o tipo único do marcador para o qual se aplica o contexto da ajuda.
- helpContextId - o id único do contexto da ajuda.
<!ELEMENT attribute EMPTY>
<!ATTLIST attribute
name CDATA #REQUIRED
value CDATA #REQUIRED>
- name - o nome do atributo cujo valor está a ser especificado.
- value - o valor especificado do atributo.
Exemplos:
A seguir encontra-se um exemplo de uma extensão de ajuda para marcadores (repare no sub-elemento e no modo como os atributos são utilizados):
<extension point=
"org.eclipse.ui.ide.markerHelp"
>
<markerHelp
markerType=
"org.eclipse.ui.examples.readmetool.readmemarker"
helpContextId=
"org.eclipse.ui.examples.readmetool.marker_example1_context"
>
<attribute name=
"org.eclipse.ui.examples.readmetool.id"
value=
"1234"
/>
</markerHelp>
</extension>
No exemplo anterior, um ID de contexto da ajuda é associado aos marcadores do tipo org.eclipse.ui.examples.readmetool.readmemarker, cujo atributo org.eclipse.ui.examples.readmetool.id tem um valor de 1234.
Informações de API:
Depende do programador assegurar que apenas é fornecido um ID único de contexto da ajuda para um determinado marcador.
Se forem fornecidos dois ou mais IDs de contexto da ajuda para um determinado tipo de marcador, a área de trabalho não define qual será devolvido.
No entanto, a área de trabalho não define que o ID de contexto "mais específico" será sempre devolvido para um determinado marcador.
Isto é, um ID de marcador associado a três valores de atributos correspondentes será devolvido antes de um ID de contexto associado a apenas dois.
Copyright (c) 2002, 2004 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