Sidonnat

org.eclipse.ui.bindings

3.1

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.



<!ELEMENT key (parameter*)>

<!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.



<!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.