Příkazy

org.eclipse.ui.commands

2.1

Bod rozšíření org.eclipse.ui.commands se používá k deklarování příkazů a kategorií příkazů, pomocí prvků příkaz a kategorie. Příkaz je abstraktním znázorněním určitého sémantického chování, ale nepředstavuje jeho vlastní implementaci. Díky tomu mohou různí vývojáři k jednotlivým částem programu přiřadit specifické chování. Může například existovat příkaz "vložit" v jedné implementaci v rámci editoru a v jiné implementaci v rámci prvku widget průzkumníka. Tyto implementace se nazývají popisovače.

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

Tento prvek se používá k definování počáteční aktivní klávesové konfigurace pro Eclipse. Pokud existuje více než jeden takovýto prvek, je považován za platný pouze poslední deklarovaný prvek (v pořadí čtení registru).

Tento prvek byl nahrazen předvolbou. Pokud je třeba ve vaší aplikaci změnit výchozí konfiguraci kláves, pak uveďte následující záznam ve svém souboru plugin_customization.ini: 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>

V uživatelském rozhraní jsou příkazy často organizovány podle kategorie, aby bylo možné je lépe spravovat. Tento prvek se používá pro definování těchto kategorií. Příkazy se mohou samy přidat k maximálně jedné kategorii. Pokud existuje více než jeden z těchto prvků se stejným atributem id, je považován za platný pouze poslední deklarovaný prvek (v pořadí čtení registru modulu plug-in).



<!ELEMENT command (commandParameter | defaultHandler?)>

<!ATTLIST command

category       CDATA #IMPLIED

description    CDATA #IMPLIED

id             CDATA #REQUIRED

name           CDATA #REQUIRED

categoryId     CDATA #IMPLIED

defaultHandler CDATA #IMPLIED>

Tento prvek se používá pro definování příkazů. Příkaz představuje požadavek od uživatele, který může být ošetřen akcí a měl by být mezi ostatními příkazy sémanticky jedinečný. Příkaz nedefinujte, pokud už je nějaký příkaz se stejným významem definovaný. Pokud existuje více než jeden z těchto prvků se stejným atributem id, je považován za platný pouze poslední deklarovaný prvek (v pořadí čtení registru modulu plug-in). Viz body rozšíření org.eclipse.ui.actionSets a org.eclipse.ui.editorActions, kde jsou uvedeny informace k pochopení toho, jak jsou akce spojeny s příkazy.



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

Tento prvek umožňuje přiřadit klávesové posloupnosti k příkazům. Použijte namísto toho prvek key v bodu rozšíření "org.eclipse.ui.bindings".



<!ELEMENT keyConfiguration EMPTY>

<!ATTLIST keyConfiguration

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED

parent      CDATA #IMPLIED

parentId    CDATA #IMPLIED>

Tento prvek se používá pro definování konfigurací kláves. Pokud existuje více než jeden z těchto prvků se stejným atributem id, je považován za platný pouze poslední deklarovaný prvek (v pořadí čtení registru modulu plug-in). Použijte namísto toho bod rozšíření "org.eclipse.ui.bindings".



<!ELEMENT context EMPTY>

<!ATTLIST context

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED

parent      CDATA #IMPLIED

parentId    CDATA #IMPLIED>

Tento prvek se používá pro definování kontextů. Pokud existuje více než jeden z těchto prvků se stejným atributem id, je považován za platný pouze poslední deklarovaný prvek (v pořadí čtení registru modulu plug-in). Použijte namísto toho bod rozšíření org.eclipse.ui.contexts.



<!ELEMENT scope EMPTY>

<!ATTLIST scope

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED

parent      CDATA #IMPLIED>

Tento prvek se používá pro definovaní rozsahů. Pokud existuje více než jeden z těchto prvků se stejným atributem id, je považován za platný pouze poslední deklarovaný prvek (v pořadí čtení registru modulu plug-in). @deprecated Použijte místo toho bod rozšíření "org.eclipse.ui.contexts".



<!ELEMENT commandParameter (values)>

<!ATTLIST commandParameter

id       CDATA #REQUIRED

name     CDATA #REQUIRED

values   CDATA #IMPLIED

optional (true | false) "true">

Definuje parametr, kterému by příkaz měl rozumět. Parametry se používají k poskytnutí dalších informací obsluze za běhu programu. Například příkaz "Zobrazit pohled" může jako parametr přijmout pohled. Popisovače by měly těmto parametrům rozumět, proto by se s popisovači mělo zacházet jako s rozhraním API.



<!ELEMENT values (parameter)>

<!ATTLIST values

class CDATA #REQUIRED>

Podrobnější verze atributu values na commandParameter.



<!ELEMENT parameter EMPTY>

<!ATTLIST parameter

name  CDATA #REQUIRED

value CDATA #REQUIRED>

Možná hodnota parametru.



<!ELEMENT defaultHandler (parameter)>

<!ATTLIST defaultHandler

class CDATA #REQUIRED>

Výchozí popisovač pro tento příkaz. Pokud není aktivní žádná jiný popisovač, bude aktivní tento popisovač. Tento popisovač bude vykazovat konflikt s jinými definicemi popisovače, u kterých chybí podmínky activeWhen. Pokud nevytváříte IExecutableExtension, můžete namísto toho použít atribut defaultHandler.



Soubor plugin.xml v modulu plug-in org.eclipse.ui rozsáhle využívá bod rozšíření org.eclipse.ui.commands.

Nejedná se o veřejné rozhraní API pro deklarování příkazů, kategorií, vazeb kláves, konfigurací kláves, nebo kontextů, jiných než tento bod rozšíření. Veřejné rozhraní API pro dotazování a nastavování kontextů, stejně tak jako pro registrování akcí k ošetření konkrétních příkazů, je uvedeno v org.eclipse.ui.IKeyBindingService.