Parancsok

org.eclipse.ui.commands

2.1

Az org.eclipse.ui.commands kiterjesztési pont a command és category elem segítségével parancsokat és parancskategóriákat ad meg. A parancs valamilyen szemantikai viselkedés ábrázolása, de nem a tényleges megvalósítása. Ez lehetővé teszi a különböző fejlesztők számára az egyéni részeik számára bizonyos viselkedés hozzáadását. Például lehet egy megvalósítással rendelkező "beillesztés" parancs egy szerkesztőben és egy másik megvalósítás egy felfedező felületi elemben. Ezen megvalósítások a kezelők.

<!ELEMENT extension (activeKeyConfiguration , category , command , keyBinding , keyConfiguration , context , scope)>

<!ATTLIST extension

id    CDATA #IMPLIED

name  CDATA #IMPLIED

point CDATA #REQUIRED>


<!ELEMENT activeKeyConfiguration EMPTY>

<!ATTLIST activeKeyConfiguration

value              CDATA #IMPLIED

keyConfigurationId CDATA #IMPLIED>

Ez az elem megadja a kezdeti aktív billentyűkonfigurációt az Eclipse-hez. Ha több ilyen elem létezik, akkor csak az utolsó megadott elem (a bedolgozónyilvántartás olvasása érdekében) érvényes.

Ez az elem kicserélésre került egy beállítással. Ha az alkalmazásnak módosítania kell az alapértelmezett billentyűbeállítást, akkor adja meg a következőt a plugin_customization.ini fájlban: org.eclipse.ui/KEY_CONFIGURATION_ID=your.default.key.configuration.id.



<!ELEMENT category EMPTY>

<!ATTLIST category

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED>

A felhasználói felületen a parancsok az egyszerűbb kezelhetőség érdekében gyakran kategóriákba vannak szervezve. Ez az elem megadja ezeket a kategóriákat. A parancsok legfeljebb egy kategóriához adhatók hozzá. Ha több ilyen elem létezik ugyanabban az id attribútumban, akkor csak az utolsó megadott elem (a bedolgozó-nyilvántartás olvasása érdekében) érvényes.



<!ELEMENT command (commandParameter | defaultHandler?)>

<!ATTLIST command

category       CDATA #IMPLIED

description    CDATA #IMPLIED

id             CDATA #REQUIRED

name           CDATA #REQUIRED

categoryId     CDATA #IMPLIED

defaultHandler CDATA #IMPLIED>

Ez az elem parancsokat ad meg. A parancs egy felhasználói kérést ábrázol, amelyet egy tevékenység kezelhet, és szemantikailag egyedinek kell lennie a többi parancs között. Ne adjon meg parancsot, ha ugyanezzel a jelentéssel már van egy megadva. Ha több ilyen elem létezik ugyanabban az id attribútumban, akkor csak az utolsó megadott elem (a bedolgozó-nyilvántartás olvasása érdekében) érvényes. Annak megértéséhez, hogy a tevékenységek hogyan vannak parancsokhoz csatlakoztatva, tekintse meg az org.eclipse.ui.actionSets és org.eclipse.ui.editorActions kiterjesztési pontot.



<!ELEMENT keyBinding EMPTY>

<!ATTLIST keyBinding

configuration      CDATA #IMPLIED

command            CDATA #IMPLIED

locale             CDATA #IMPLIED

platform           CDATA #IMPLIED

contextId          CDATA #IMPLIED

string             CDATA #IMPLIED

scope              CDATA #IMPLIED

keyConfigurationId CDATA #IMPLIED

commandId          CDATA #IMPLIED

keySequence        CDATA #IMPLIED>

Az elem lehetővé teszi billentyűkombinációk parancsokhoz rendelését. Inkább a key elemet használja az "org.eclipse.ui.bindings" kiterjesztési pontban.



<!ELEMENT keyConfiguration EMPTY>

<!ATTLIST keyConfiguration

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED

parent      CDATA #IMPLIED

parentId    CDATA #IMPLIED>

Ez az elem billentyűkonfigurációkat ad meg. Ha több ilyen elem létezik ugyanabban az id attribútumban, akkor csak az utolsó megadott elem (a bedolgozó-nyilvántartás olvasása érdekében) érvényes. Használja inkább az "org.eclipse.ui.bindings" kiterjesztési pontot.



<!ELEMENT context EMPTY>

<!ATTLIST context

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED

parent      CDATA #IMPLIED

parentId    CDATA #IMPLIED>

Az elem megadja a kontextusokat. Ha több ilyen elem létezik ugyanabban az id attribútumban, akkor csak az utolsó megadott elem (a bedolgozó-nyilvántartás olvasása érdekében) érvényes. Inkább az org.eclipse.ui.contexts kiterjesztési pontot használja.



<!ELEMENT scope EMPTY>

<!ATTLIST scope

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED

parent      CDATA #IMPLIED>

Ez az elem hatóköröket ad meg. Ha több ilyen elem létezik ugyanabban az id attribútumban, akkor csak az utolsó megadott elem (a bedolgozó-nyilvántartás olvasása érdekében) érvényes. @elavult Használja inkább az "org.eclipse.ui.contexts" kiterjesztési pontot.



<!ELEMENT commandParameter (values)>

<!ATTLIST commandParameter

id       CDATA #REQUIRED

name     CDATA #REQUIRED

values   CDATA #IMPLIED

optional (true | false) "true">

Egy olyan paramétert határoz meg, amelyet egy parancsnak meg kell értenie. A paraméter az információk kezelő számára a végrehajtás időpontjában biztosításának egyik módja. Például egy "nézet megjelenítése" parancs elfogadhat egy nézetet paraméterként. A kezelőknek meg kell érteniük ezen paramétereket ahhoz, hogy API-kként legyenek kezelve.



<!ELEMENT values (parameter)>

<!ATTLIST values

class CDATA #REQUIRED>

A values attribútum részletesebb változata a commandParameter esetén.



<!ELEMENT parameter EMPTY>

<!ATTLIST parameter

name  CDATA #REQUIRED

value CDATA #REQUIRED>

A paraméter egy lehetséges értéke.



<!ELEMENT defaultHandler (parameter)>

<!ATTLIST defaultHandler

class CDATA #REQUIRED>

A parancs alapértelmezett kezelője. Ha nincs más aktív kezelő, akkor ez a kezelő lesz aktív. Ez a kezelő ütközni fog az olyan kezelőmeghatározásokkal, amelyek nem adnak meg activeWhen feltételeket. Ha nem egy IExecutableExtension felületet hoz létre, akkor a defaultHandler attribútumot használja inkább.



Az org.eclipse.ui bedolgozóban lévő plugin.xml fájl átfogóan használja az org.eclipse.ui.commands kiterjesztési pontot.

Ezen kiterjesztési ponton kívül nincs nyilvános API parancsok, kategóriák, billentyűkombinációk vagy kontextusok megadásához. Nyilvános API a kontextusok lekérdezéséhez és beállításához, valamint tevékenységek bejegyzéséhez az org.eclipse.ui.IKeyBindingService elemben található speciális parancsok kezeléséhez.