Ayuda de marcadores
Identificador:
org.eclipse.ui.ide.markerHelp
A partir del release:
3.0 (originariamente añadido en el release 2.0 como org.eclipse.ui.markerHelp)
Descripción:
Este punto de extensión permite asociar un ID de
contexto de ayuda a una "especie" concreta de marcador (un marcador de un tipo
determinado o que tiene determinados valores de atributos).
Código de configuración:
<!ELEMENT extension (markerHelp*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point: identificador totalmente calificado del punto de extensión destino
- id: identificador opcional de la instancia de extensión
- name: nombre opcional de la instancia de extensión
<!ELEMENT markerHelp (attribute*)>
<!ATTLIST markerHelp
markerType CDATA #IMPLIED
helpContextId CDATA #REQUIRED>
- markerType: tipo exclusivo del marcador para el que es aplicable el
contexto de la ayuda.
- helpContextId: ID exclusivo del contexto de la ayuda.
<!ELEMENT attribute EMPTY>
<!ATTLIST attribute
name CDATA #REQUIRED
value CDATA #REQUIRED>
- name: nombre del atributo cuyo valor se está especificando.
- value: valor especificado del atributo.
Ejemplos:
A continuación figura un ejemplo de extensión de
ayuda de marcador (observe el subelemento y la manera de utilizar los atributos):
<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>
En el ejemplo anterior, hay un ID de contexto de ayuda asociado a los
marcadores de tipo org.eclipse.ui.examples.readmetool.readmemarker cuyo
atributo org.eclipse.ui.examples.readmetool.id tiene el valor 1234.
Información sobre las API:
El desarrollador es el responsable de garantizar que únicamente se suministre un solo ID de contexto de ayuda para un marcador dado.
Si se suministran dos o más ID de contexto de ayuda para un
determinado tipo de marcador, el entorno de trabajo no define cuál de ellos se
devolverá.
Sin embargo, el entorno de trabajo sí define que se devuelva siempre
el ID de contexto que sea "más específico" del marcador en cuestión.
Por ejemplo,
se devolvería un ID de contexto asociado que tuviera tres valores de atributo
coincidentes antes que un ID de contexto asociado que tan solo tuviera dos.
Copyright (c) 2002, 2004 IBM Corporation y otros.
Reservados todos los derechos. Este programa y sus materiales adjuntos están
disponibles bajo los términos de la licencia pública común (Eclipse Public
License) v1.0 que acompaña a esta distribución, y está disponible en
http://www.eclipse.org/legal/epl-v10.html