Az org.eclipse.ui.bindings
kiterjesztési pont kötések és sémák
deklarálására használható. Egy séma néhány kötés halmaza. Egy kötés egy adott
feltételcsoport, néhány felhasználói bemenet és egy aktivált parancs közti
leképezés.
Minden kötés igényel valamilyen aktiválást, egy környezetet, amelyben aktív és
egy sémát, amelyben létezik. Ha nem biztos abban, hogy mely környezetet
válassza, akkor hagyja üresen. Az alapértelmezés az
"org.eclipse.ui.contexts.window"
környezet lesz. Ez a környezet
azt jelenti, hogy a kötés az Eclipse bármely fő ablakában alkalmazásra
kerülhet. Amikor a környezet aktívvá válik, akkor a kötés is aktívvá fog válni.
Az utódkörnyezetekből származó kötések újradefiniálják a szülőkörnyezetekből
származó kötéseket. A környezetekkel kapcsolatos további információk az
org.eclipse.ui.contexts
kiterjesztési pont leírásában találhatók.
Ha egy kötés nem határoz meg egy parancsazonosítót, akkor az egy törlésjelző. Ez azt jelenti, hogy minden feltétel kielégítése esetén minden kötést vissza fog vonni, amely ugyanazon aktiválóval rendelkezik ugyanazon környezetben. Ez a mechanizmus például egy kötés adott platformon módosítására használható.
A kötések egyik típusa a billentyűkombináció
(másnéven
billentyűparancs). Például a Ctrl+C
billentyűk
Másolás
művelethez kötésére billentyűkombinációként
gondolhatunk. Egy billentyűkombinációhoz tartozó aktiváló valójában
billentyűlenyomások sorozata.
Egy séma ezen kötések csoportjának halmaza, amelyből a végfelhasználó válaszhat. Például egy felhasználó az alapértelmezett sémát szeretné használni, de egy Emacs stílusú vagy egy Brief stílusú sémát is szeretne használni.
<!ELEMENT extension (scheme , key)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT scheme EMPTY>
<!ATTLIST scheme
id CDATA #REQUIRED
name CDATA #REQUIRED
description CDATA #IMPLIED
parentId CDATA #IMPLIED>
A séma olyan kötések csoportja, amelyeket a végfelhasználó kiválaszthat használatra.
Lehetséges a sémák számára a kötések szülősémából örökölése. Ennek az a célja, hogy egyszerűbbé tegye a bedolgozófejlesztők számára az egyéni kötési halmazok létrehozását. Egy utódsémában megadott aktív kötés minden esetben újra fog definiálni egy aktív kötést a szülősémában, ha ugyanazzal az aktiválóval rendelkeznek. Ez az eljárás az Emacs séma munkaterületben biztosítására használható.
<!ATTLIST key
sequence CDATA #REQUIRED
schemeId CDATA #REQUIRED
contextId CDATA "org.eclipse.ui.contexts.window"
commandId CDATA #IMPLIED
platform CDATA #IMPLIED
locale CDATA #IMPLIED>
Kötés valamilyen billentyűbemenet és a parancs aktiválása között.
A kötés billentyűkombinációja. A billentyűkombinációnak néhány
billentyűleütésből kell állnia. A billentyűleütések szóközökkel vannak
elválasztva. A billentyűleütések néhány egyidőben lenyomva tartott billentyűből állnak.
Ennek nulla vagy több módosító billentyűnek és egy másik billentyűnek kell
lennie. A billentyűk a +
karakterrel vannak elválasztva.
A felismert módosító billentyűk a következők: M1
, M2
,
M3
, M4
, ALT
, COMMAND
,
CTRL
és SHIFT
. Az "M" módosító billentyűk a
billentyűk ábrázolásának platformfüggetlen módjai, és általában ezek vannak
előnyben részesítve. Az M1
a COMMAND
billentyűt
jelenti MacOS X rendszeren és a CTRL
billentyűt a legtöbb más
platformon. Az M2
a SHIFT
billentyűt jelenti. Az
M3
az Option
billentyűt jelenti MacOS X rendszeren és
az ALT
billentyűt a legtöbb más platformon. Az M4
a
CTRL
billentyűt jelenti MacOS X rendszeren és meghatározatlan a
többi platformon.
A tényleges billentyű általában a ASCII karakterhez hasonlóan kerül megadásra
nagybetűsként. Így például az F
vagy ,
karakterek az
ilyen billentyűk példái. Azonban létezik néhány speciális billentyű, amelyeknek
nincs nyomtatható ASCII ábrázolása. Alább a jelenleg használt speciális
billentyűk listája látható: ARROW_DOWN
, ARROW_LEFT
,
ARROW_RIGHT
, ARROW_UP
, BREAK
,
BS
, CAPS_LOCK
, CR
, DEL
,
END
, ESC
, F1
, F2
,
F3
, F4
, F5
, F6
,
F7
, F8
, F9
, F10
,
F11
, F12
, F13
, F14
,
F15
, FF
, HOME
, INSERT
,
LF
, NUL
, NUM_LOCK
,
NUMPAD_0
, NUMPAD_1
, NUMPAD_2
,
NUMPAD_3
, NUMPAD_4
, NUMPAD_5
,
NUMPAD_6
, NUMPAD_7
, NUMPAD_8
,
NUMPAD_9
, NUMPAD_ADD
, NUMPAD_DECIMAL
,
NUMPAD_DIVIDE
, NUMPAD_ENTER
,
NUMPAD_EQUAL
, NUMPAD_MULTIPLY
,
NUMPAD_SUBTRACT
, PAGE_UP
, PAGE_DOWN
,
PAUSE
, PRINT_SCREEN
, SCROLL_LOCK
,
SPACE
, TAB
ÉS VT
.
Néhány alternatív nevet is használunk néhány általános speciális billentyű
esetén. Például az ESC
és az ESCAPE
is elfogadott,
valamint a CR
, ENTER
és RETURN
mind
ugyanazt jelenti.
A rövid billentyűkombinációk használata is erősen ajánlott. Egy-két billentyűnél többre nem lesz szüksége. A környezetek használatával a billentyűkombinációk számára az alkalmazás különböző részein különböző jelentéseket adhat meg. Semmiképpen se használjon olyan billentyűkombinációt, amely négynél több billentyűleütést tartalmat.
org.eclipse.ui.contexts
kiterjesztési pontot. Ha ez nincs megadva, akkor az alapértelmezés az
org.eclipse.ui.contexts.window
lesz.Azon parancs azonosítója, amelyet végre kell hajtani a kötés aktiválásakor.
Ha nincs megadva parancsazonosító, akkor ez egy törlésjelző. Ez azt jelenti, hogy az azonos környezetben lévő azonos kombinációval, platformmal és helyszínnel rendelkező kötések inaktívvá fognak válni ezen kötés aktívvá válásakor. Ha a platform vagy helyszín nincs megadva egy törlés esetén, akkor minden platformnak és helyszínnek megfelel.
SWT.getPlatform()
metódusból származó
karaktersorozatot. Például a következő karaktersorozatok érvényesek:
win32
, gtk
, motif
, carbon
és photon
.Locale.toString()
esetén. Például az "en"
és
"en_CA"
is megfelelő.<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
id CDATA #IMPLIED
value CDATA #IMPLIED>
Egy paraméter neve és értéke, amelyet a parancs számára kell átadni annak végrehajtásakor. Ez lehetővé teszi a parancs valamilyen módon minősítését. Például egy "Nézet megjelenítése" parancs elfogadhatja a nézetazonosítót paraméterként.
<extension point=
"org.eclipse.ui.bindings"
>
<key sequence=
"M2+F5"
commandId=
"commandId"
schemeId=
"default"
contextId=
"windows"
/>
<scheme name=
"Default"
description=
"Eclipse alapértelmezett gyorsbillentyűi"
id=
"default"
/>
</extension>
A kötések meghatározásához nincs nyilvános API. A felhasználók számára a
stabilitás elérésének megkísérléséhez a kötések csak kiterjesztési pontokon
keresztül kerülnek meghatározásra. RCP alkalmazás esetén ezt a viselkedést újra
kell tudni definiálni a WorkbenchAdvisor
elemben.
Ahhoz, hogy a kötések működjenek, meg kell adni egy parancsot. A kötés működéséhez a parancsnak rendelkeznie kell egy aktív kezelővel. A kezelők programból jegyezhetők be. Tekintse meg az org.eclipse.ui.handlers kiterjesztési pont leírását.
Copyright (c) 2005 IBM Corporation és mások.
Minden jog fenntartva. Jelen program és annak kísérőanyagai a csomaghoz
tartozó, illetve a
http://www.eclipse.org/legal/epl-v10.html
címen is elérhető Eclipse Public License 1.0 verziójának hatálya alatt lettek
közzétéve.