Representaciones de memoria
Identificador:
org.eclipse.debug.ui.memoryRenderings
A partir de:
3.1: sustitucion del
punto de extensión memoryRenderingTypes que estaba considerado como
experimental en la versión 3.0
Descripción:
permite que los
conectores contribuyan con representaciones arbitrarias de bloques de
memoria y enlace bloques de memoria con representaciones. Por ejemplo, una representación puede convertir bytes sin formato de un bloque
de memoria en caracteres ASCII.
Códigos de configuración:
<!ELEMENT extension (renderingType* | renderingBindings*)>
<!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 renderingType EMPTY>
<!ATTLIST renderingType
name CDATA #REQUIRED
id CDATA #REQUIRED
class CDATA #REQUIRED>
Este elemento define un tipo de representación.
- name: nombre de este tipo de representación legible por los
usuarios
- id: identificador exclusivo de esta representación
- class: nombre totalmente calificado de la clase Java que implementa
org.eclipse.debug.ui.memory.IMemoryRenderingTypeDelegate
<!ELEMENT renderingBindings (enablement*)>
<!ATTLIST renderingBindings
renderingIds CDATA #IMPLIED
primaryId CDATA #IMPLIED
class CDATA #IMPLIED
defaultIds CDATA #IMPLIED>
Enlaza bloques de memoria con las representaciones disponibles.
- renderingIds: lista delimitada por comas de identificadores de un tipo
de representación de memoria, especificando tipos de representación para los
bloques de memoria para los que este enlace está habilitado. No debe especificarse cuando se proporciona
class
.
- primaryId: identificador del tipo de representación de memoria,
especificando el tipo de representación por omisión
que se considerará primario para los bloques de memoria para los que este enlace
está habilitado. Cuando hay más de un tipo de representación por omisión enlazado a un bloque de
memoria, la UI puede utilizar la información para determinar qué representación
debe hacerse visible (es decir, la primaria). No debe especificarse cuando se proporciona
class
.
Los clientes deben procurar especificar sólo un tipo de representación
primario por bloque de memoria.
- class: nombre totalmente calificado de la clase Java que implementa
org.eclipse.debug.ui.memory.IMemoryRenderingBindingsProvider
, lo
que permite enlaces de representación dinámicos. Cuando se especifique, no deberá especificarse renderingIds
,
defaultIds
ni primaryId
.
- defaultIds: lista delimitada por comas de identificadores de tipo de
representación de memoria, especificando tipos de representación por omisión
para los bloques de memoria para los que este enlace está habilitado. No debe especificarse cuando se proporciona
class
.
Ejemplos:
A continuación se
muestra un ejemplo de definición de un nuevo tipo de representación y enlace.
<extension point=
"org.eclipse.debug.ui.memoryRenderings"
>
<renderingType
name=
"Sample Rendering"
id=
"com.example.sampleRendering"
class=
"com.example.SampleRenderingTypeDelegate"
>
</renderingType>
<renderingBindings
renderingIds=
"com.example.sampleRendering"
>
<enablement>
<instanceof value=
"com.example.SampleMemoryBlock"
/>
</enablement>
</renderingBindings>
</extension>
En el ejemplo anterior, se define un nuevo tipo de representación, Sample Rendering. La clase com.example.SampleRenderingTypeDelegate
implementa
org.eclipse.debug.ui.memory.IMemoryRenderingTypeDelegate
y se
utilizará para crear nuevas representaciones de este tipo. La representación se enlaza a instancias de
com.exmaple.SampleMemoryBlock
.
Información sobre las API:
El valor del atributo class en un elemento renderingType
debe ser un nombre totalmente calificado de una clase Java que implementa
org.eclipse.debug.ui.memory.IMemoryRenderingTypeDelegate.
El valor del atributo class en un elemento renderingBindings
debe ser un nombre totalmente calificado de una clase Java que implementa
org.eclipse.debug.ui.memory.IMemoryRenderingBindingsProvider.
Implementación suministrada:
La plataforma de depuración proporciona los siguientes tipos de representación:
Representación hexadecimal (ID de representación:
org.eclipse.debug.ui.rendering.raw_memory)
Representación ASCII ID de representación:
org.eclipse.debug.ui.rendering.ascii)
Representación de entero con signo (ID de representación:
org.eclipse.debug.ui.rendering.signedint)
Representación de entero sin signo (ID de representación:
org.eclipse.debug.ui.rendering.unsignedint)
La plataforma de depuración proporciona una vista de memoria para albergar
representaciones.
Copyright (c) 2004, 2005 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