Renderowania pamięci
Identyfikator:
org.eclipse.debug.ui.memoryRenderings
Dostępne od wersji:
3.1 - wymiana punktu rozszerzenia memoryRenderingTypes, który był traktowany jako eksperymentalny w wersji 3.0
Opis:
Umożliwia modułom dodatkowym wnoszenie dowolnych renderowań dla bloków pamięci oraz wiązanie bloków pamięci z renderowaniami. Na przykład operacja renderowania może tłumaczyć bajty bezpośrednio z bloku pamięci na znaki ASCII.
Znaczniki konfiguracji:
<!ELEMENT extension (renderingType* | renderingBindings*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - pełny identyfikator docelowego punktu rozszerzenia.
- id - opcjonalny identyfikator instancji rozszerzenia.
- name - opcjonalna nazwa instancji rozszerzenia.
<!ELEMENT renderingType EMPTY>
<!ATTLIST renderingType
name CDATA #REQUIRED
id CDATA #REQUIRED
class CDATA #REQUIRED>
Ten element definiuje typ renderowania.
- name - czytelna dla człowieka nazwa typu renderowania.
- id - unikalny identyfikator dla tego typu renderowania.
- class - pełna nazwa klasy Java implementującej interfejs
org.eclipse.debug.ui.memory.IMemoryRenderingTypeDelegate
.
<!ELEMENT renderingBindings (enablement*)>
<!ATTLIST renderingBindings
renderingIds CDATA #IMPLIED
primaryId CDATA #IMPLIED
class CDATA #IMPLIED
defaultIds CDATA #IMPLIED>
Wiąże bloki pamięci z dostępnymi renderowaniami.
- renderingIds - oddzielona przecinkami lista identyfikatorów typów renderowań pamięci, określająca dostępne typy renderowań dla bloków pamięci, dla których to powiązanie jest włączone. Atrybutu nie należy określać, jeśli jest udostępniany atrybut
class
.
- primaryId - identyfikator typu renderowania pamięci, określający domyślny typ renderowania traktowany jako podstawowy dla bloków pamięci, dla których to powiązanie jest włączone. Jeśli istnieje więcej niż jeden domyślny typ renderowania przypisany do bloku pamięci, interfejs użytkownika może używać tej informacji do określenia, które renderowanie powinno być widoczne (tj. podstawowe). Atrybutu nie należy określać, jeśli jest udostępniany atrybut
class
. Należy zachować ostrożność i określać tylko jeden podstawowy typ renderowania dla każdego bloku pamięci.
- class - pełna nazwa klasy Java implementującej interfejs
org.eclipse.debug.ui.memory.IMemoryRenderingBindingsProvider
, który umożliwia dynamiczne powiązania renderowań. Po określeniu tego atrybutu nie trzeba określać atrybutów renderingIds
, defaultIds
i primaryId
.
- defaultIds - lista rozdzielonych przecinkami identyfikatorów typów renderowań, określająca domyślne typy renderowań dla bloków pamięci, dla których to powiązanie jest włączone. Atrybutu nie należy określać, jeśli jest udostępniany atrybut
class
.
Przykłady:
Poniżej przedstawiono przykładową definicję nowego typu renderowania i powiązania.
<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>
W powyższym przykładzie został zdefiniowany nowy typ renderowania o nazwie
Sample Rendering. Klasa com.example.SampleRenderingTypeDelegate
implementuje interfejs org.eclipse.debug.ui.memory.IMemoryRenderingTypeDelegate
i zostanie użyta do utworzenia nowych renderowań tego typu. Renderowanie
jest przypisane do instancji klasy com.example.SampleMemoryBlock
.
Informacje o interfejsie API:
Wartość atrybutu class elementu renderingType musi być pełną
nazwą klasy Java implementującej interfejs org.eclipse.debug.ui.memory.IMemoryRenderingTypeDelegate.
Wartość atrybutu class elementu renderingBindings musi być pełną nazwą klasy Java implementującej interfejs org.eclipse.debug.ui.memory.IMemoryRenderingBindingsProvider.
Dostarczana implementacja:
Platforma debugowania udostępnia następujące typy renderowania:
Renderowanie szesnastkowe (identyfikator renderowania: org.eclipse.debug.ui.rendering.raw_memory)
Renderowanie ASCII (identyfikator renderowania: org.eclipse.debug.ui.rendering.ascii)
Renderowanie całkowite ze znakiem (identyfikator renderowania: org.eclipse.debug.ui.rendering.signedint)
Renderowanie całkowite bez znaku (identyfikator renderowania: org.eclipse.debug.ui.rendering.unsignedint)
Platforma debugowania udostępnia widoki pamięci do obsługi renderowań.
Copyright (c) 2004, 2005 IBM Corporation i inne podmioty.
Wszelkie prawa zastrzeżone. Program ten oraz towarzyszące mu materiały są udostępniane na warunkach
licencji EPL (Eclipse Public License), wersja 1.0, dołączonej do nich i
dostępnej pod adresem http://www.eclipse.org/legal/epl-v10.html.