Powiązania widoków z kontekstem
Identyfikator:
org.eclipse.debug.ui.contextViewBindings
Dostępne od wersji:
3.0
Opis:
Ten punkt rozszerzenia udostępnia mechanizm służący do
powiązywania widoku z identyfikatorem kontekstu. Aktywowanie kontekstu przez
widok debugowania powoduje, że widoki powiązane z tym kontekstem (a także z
ewentualnymi kontekstami nadrzędnymi) są otwierane, zamykane lub aktywowane.
Istnieje możliwość wyłączenia automatycznego otwierania i zamykania.
Znaczniki konfiguracji:
<!ELEMENT extension (contextViewBinding*)>
<!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 contextViewBinding EMPTY>
<!ATTLIST contextViewBinding
contextId CDATA #REQUIRED
viewId CDATA #REQUIRED
autoOpen (true | false)
autoClose (true | false) >
- contextId - określa identyfikator kontekstu, który odpowiada temu
powiązaniu.
- viewId - określa identyfikator widoku, który ma być powiązany z
podanym kontekstem. Aktywowanie wskazanego kontekstu spowoduje automatyczne
wysunięcie do przodu wybranego widoku. Podczas wybierania elementów w widoku
debugowania następuje automatyczne aktywowanie powiązanych z nimi kontekstów
(zgodnie z rozszerzeniami punktu rozszerzenia debugModelContextBindings).
Należy zauważyć, że dochodzi do tego jedynie w perspektywach, dla których
użytkownik wybrał opcję automatycznego zarządzania widokami przy użyciu
odpowiednich preferencji (domyślnie dotyczy to tylko perspektywy debugowania).
- autoOpen - określa, czy dany widok ma być automatycznie otwierany
przy aktywowaniu podanego kontekstu. Jeśli nie określono wartości atrybutu, przyjmowana jest wartość
true
. Podanie wartości false
spowoduje, że widok nie będzie automatycznie otwierany, ale jeśli w momencie aktywowania danego kontekstu będzie już otwarty, zostanie przeniesiony na pierwszy plan. Zaleca
się wybranie wartości false
, aby uniknąć przepełniania perspektywy widokami, które są używane tylko sporadycznie.
- autoClose - poza nielicznymi przypadkami nie zaleca się określania
tego atrybutu. Wskazuje on, czy widok ma być automatycznie zamykany przy
wyłączeniu danego kontekstu (dzieje się tak, gdy wszystkie cele debugowania
zawierające określony kontekst zostaną zakończone). Jeśli nie określono wartości atrybutu, przyjmowana jest wartość
true
. Z wartości false
należy skorzystać w mało prawdopodobnym scenariuszu, w którym widok debugowania musi pozostawać otwarty nawet wtedy, gdy użytkownik nie przeprowadza debugowania.
Przykłady:
Poniżej przedstawiono przykład dodania powiązania
widoku z kontekstem:
<extension
point=
"org.eclipse.debug.ui.contextViewBindings"
>
<contextViewBinding
contextId=
"com.example.mydebugger.debugging"
viewId=
"com.example.view"
autoOpen=
"true"
autoClose=
"false"
>
</contextViewBinding>
</extension>
W powyższym przykładzie w przypadku aktywowania kontekstu o podanym
identyfikatorze przez widok debugowania zostanie automatycznie otwarty
określony widok. W przypadku aktywowania kontekstu powiązanego z innym modelem
debugowania, który nie jest powiązany ze wskazanym widokiem, widok nie
zostanie automatycznie zamknięty.
Copyright (c) 2003, 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.