Org.eclipse.ui.bindings
-laajennuspisteen avulla määritetään sidonnat ja mallit. Mallit ovat yhden tai useamman sidonnan joukkoja. Sidonta on tietyn ehtoryhmän, käyttäjän syötteen ja liipaistun komennon välinen vastaavuusmääritys.
Kaikkia sidontoja varten on määritettävä jokin liipaisin, aktivointikonteksti ja malli. Jos et ole varma kontekstista, jätä se tyhjäksi. Tällöin oletuskontekstina käytetään org.eclipse.ui.contexts.window
-arvoa. Tässä kontekstissa sidos on käytössä kaikissa Eclipse-pääikkunoissa. Kun konteksti aktivoidaan, myös sidos aktivoidaan. Alikontekstien sidonnat ovat ensisijaisia pääkontekstien sidontoihin verrattuina. Lisätietoja konteksteista on org.eclipse.ui.contexts
-laajennuspisteen ohjeessa.
Jos sidontaan ei ole määritetty komentotunnusta, sidonta on poistomerkintä. Tällöin sidonta peruuttaa kaikki määritetyn liipaisimen sidonnat määritetyssä kontekstissa, kun kaikki ehdot täyttyvät. Tätä mekanismia voi käyttää esimerkiksi tietyn käyttöympäristön sidonnan muuttamiseen.
Näppäinsidonta
(esimerkiksi näppäimistön pikanäppäinmääritykset) on yksi sidontalaji. Esimerkiksi sidonta Ctrl+C
- Kopioi
on näppäinsidonta
. Näppäinsidonnan liipaisin on tietty näppäinyhdistelmä.
Malli on sidontajoukko, joista käyttäjä voi valita haluamansa mallin. Oletusmallia käyttävä käyttäjä voi esimerkiksi haluta, että hänellä on käytettävissään myös Emacs- ja Brief-tyylin mallit.
<!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>
Malli on sidonnoista muodostettu joukko, jonka peruskäyttäjä voi valita käyttöön.
Mallien sidonnat voivat periytyä päämallista. Tämän mekanismin avulla lisäosien kehittäjät voivat luoda helposti mukautettuja sidontajoukkoja. Alimalliin määritetty aktiivinen sidonta on aina ensisijainen päämallin aktiiviseen malliin nähden, jos niiden liipaisin on sama. Tätä tekniikkaa hyödynnetään työympäristön Emacs-mallissa.
<!ATTLIST key
sequence CDATA #REQUIRED
schemeId CDATA #REQUIRED
contextId CDATA "org.eclipse.ui.contexts.window"
commandId CDATA #IMPLIED
platform CDATA #IMPLIED
locale CDATA #IMPLIED>
Tämä on näppäimistösyötteen ja komennon liipaisun välinen sidonta.
Tämän sidonnan näppäinyhdistelmä. Sen tulee olla yhden tai useamman näppäimen määritys. Näppäinmääritykset erotetaan toisistaan tyhjämerkeillä. Näppäinmääritykset voivat koostua useasta samaan aikaan painettavasta näppäimestä. Tämä arvo voi olla näppäimen nimi tai näppäimen ja erikoisnäppäimen nimien yhdistelmä. Näppäimet erotetaan plusmerkillä (+
).
Tuetut erikoisnäppäinten arvot ovat M1
, M2
, M3
, M4
, ALT
, COMMAND
, CTRL
ja SHIFT
(vaihto). M-alkuiset määritykset ovat käyttöympäristöstä riippumattomia erikoisnäppäinvastineita, joita suositellaan käytettäväksi ensisijaisesti. M1
vastaa komentonäppäintä
MacOS X -käyttöjärjestelmässä ja CTRL
-näppäintä useimmissa muissa käyttöjärjestelmissä. M2
vastaa vaihtonäppäintä
. M3
vastaa optionäppäintä
MacOS X -käyttöjärjestelmässä ja ALT
-näppäintä useimmissa muissa käyttöjärjestelmissä. M4
vastaa CTRL
-näppäintä MacOS X -käyttöjärjestelmässä; muissa käyttöjärjestelmissä sille ei ole vastinetta.
Varsinaiset näppäimet määritetään yleensä isoilla kirjoitetulla ASCII-merkillä. Esimerkiksi F
ja ,
ovat näppäinmäärityksiä. Joillakin näppäimillä ei kuitenkaan ole ASCII-vastinetta. Tällaisia näppäimiä ovat ARROW_DOWN
(alanuolinäppäin), ARROW_LEFT
(vasen nuolinäppäin), ARROW_RIGHT
(oikea nuolinäppäin), ARROW_UP
(ylänuolinäppäin), BREAK
, BS
(askelpalautin), CAPS_LOCK
, CR
(Return), DEL
, END
, ESC
, F1
, F2
, F3
, F4
, F5
, F6
, F7
, F8
, F9
, F10
, F11
, F12
, F13
, F14
, F15
, FF
(sivunvaihto), HOME
, INSERT
, LF
(rivinvaihto), NUL
(tyhjämerkki), NUM_LOCK
, NUMPAD_0
(NUMPAD = numeronäppäimistön näppäin), NUMPAD_1
, NUMPAD_2
, NUMPAD_3
, NUMPAD_4
, NUMPAD_5
, NUMPAD_6
, NUMPAD_7
, NUMPAD_8
, NUMPAD_9
, NUMPAD_ADD
(plus), NUMPAD_DECIMAL
(pilkku), NUMPAD_DIVIDE
(jakomerkki), NUMPAD_ENTER
, NUMPAD_EQUAL
(yhtäsuuruusmerkki), NUMPAD_MULTIPLY
(kertomerkki), NUMPAD_SUBTRACT
(miinus), PAGE_UP
, PAGE_DOWN
, PAUSE
, PRINT_SCREEN
, SCROLL_LOCK
, SPACE
(välilyönti), TAB
(sarkain) ja VT
(pystysarkain).
Joillakin näppäimillä on vaihtoehtoisia nimiä. Esimerkiksi ESC
ja ESCAPE
tarkoittavat samaa näppäintä, kuten myös CR
, ENTER
ja RETURN
.
Näppäinyhdistelmät kannattaa pitää lyhyinä. Yksi tai kaksi näppäintä on yleensä riittävä. Kontekstien avulla näppäinyhdistelmälle voi määrittää eri toimintoja sovelluksen eri osiin. Missään näppäinyhdistelmässä ei suositella käytettäväksi useampaa kuin neljää näppäilyä.
org.eclipse.ui.contexts
-laajennuspisteen ohjeessa. Jos tälle määritteelle ei ole annettu arvoa, käytetään org.eclipse.ui.contexts.window
-oletusarvoa.sen komennon tunnus, joka toteutetaan, kun tämä sidonta liipaistaan.
Jos komennon tunnusta ei ole määritetty, kyseessä on poistomerkintä. Tällöin kaikki määritetyn kontekstin sidonnat, joilla on määritetty näppäinyhdistelmä, käyttöympäristö ja paikallistunnus, poistetaan käytöstä, kun sidonta aktivoidaan. Jos poistolle ei ole määritetty käyttöympäristöä tai paikallistunnusta, sitä käytetään kaikissa käyttöympäristöissä tai paikallistunnuksissa.
SWT.getPlatform()
-metodissa. Kelvollisia arvoja ovat esimerkiksi win32
, gtk
, motif
, carbon
ja photon
.Locale.toString()
-metodissa. Kelvollisia arvoja ovat esimerkiksi "en"
ja "en_CA"
.<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
id CDATA #IMPLIED
value CDATA #IMPLIED>
Parametrin nimi ja arvo on välitettävä komennolle sitä suoritettaessa. Näin voidaan tarkentaa komennon suoritusta. Esimerkiksi komennossa, joka tuo näkyviin näkymän, parametri voisi olla näkymän tunnus.
<extension point=
"org.eclipse.ui.bindings"
>
<key sequence=
"M2+F5"
commandId=
"commandId"
schemeId=
"default"
contextId=
"windows"
/>
<scheme name=
"Oletusarvo"
description=
"Palauttaa Eclipse-pikavalintojen oletusarvot"
id=
"default"
/>
</extension>
Sidontojen määritystä varten ei ole julkista API-rajapintaa. Toimintavakauden ylläpitämiseksi sidonnat määritetään vain laajennuspisteiden avulla. RCP-sovellukset voivat poiketa tästä toimintatavasta WorkbenchAdvisor
-määrityksen avulla.
Jotta sidonta toimisi, komennon on oltava määritetty. Komennolle on oltava määritetty aktiivinen käsittelytoiminto. Käsittelytoiminnot voi rekisteröidä ohjelmallisesti org.eclipse.ui.handlers-laajennuspisteen ohjeen mukaisesti.
Copyright (c) 2005 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html