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
.
id
attribute) prvku keyConfiguration, pro který si přejeme, aby byl na začátku aktivní.id
attribute) prvku keyConfiguration, pro který si přejeme, aby byl na začátku aktivní.<!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.
activeWhen
. Pokud vytváříte IExecutableExtension
, můžete namísto toho použít prvek defaultHandler
.<!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".
java.util.Locale
.platform
jsou sadou možných hodnot, které vrací org.eclipse.swt.SWT.getPlatform()
.schemeId
na prvku key
v novém bodu rozšíření "org.eclipse.ui.bindings".Sekvence kláves, která se má přiřadit k příkazu. Sekvence kláves se skládají z jednoho nebo více stisků kláves, přičemž stisk klávesy se skládá z klávesy na klávesnici, volitelně stisknuté v kombinaci s jedním nebo více z následujících modifikátorů: Ctrl, Alt, Shift a Příkaz. Stisky kláves jsou odděleny mezerami a modifikátory jsou odděleny pomocí znaku '+'.
Klávesy modifikátoru jsou vyjádřeny způsobem nezávislým na dané platformě. Například na systému MacOS X se téměř vždy namísto "Ctrl" používá "Command". Proto používáme "M1", které se mapuje buďto na "Ctrl" nebo "Command", podle použitého systému. Podobně se "M2" mapuje na "Shift"; "M3" na "Alt"; a "M4" na "Ctrl" (MacOS X). Pokud se přidají další platformy, můžete se spolehnout na tyto aliasy, které se budou mapovat na správné výchozí klávesy v závislosti na platformě.
Syntaxe pro tento řetězec je definována v org.eclipse.ui.internal.keys
. V krátkosti, v řetězci se nerozlišují malá a velká písmena -- ačkoli se ze stylistických důvodů dává přednost velkým písmenům. Pokud klávesa představuje písmeno, pak jednoduše doplňte písmeno. Pokud je klávesa speciálním znakem (tj. mimo ASCII), použijte jednu z následujících možností: ARROW_DOWN, ARROW_LEFT, ARROW_RIGHT, ARROW_UP, BREAK, CAPS_LOCK, END, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, F13, F14, F15, HOME, INSERT, 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, or SCROLL_LOCK. Pokud klávesa představuje netisknutelný znak ASCII, použijte jednu z těchto možností: BS, CR, DEL, ESC, FF, LF, NUL, SPACE, TAB nebo VT. Vezměte na vědomí, že klávesou Enter/Return na hlavní klávesnici je CR.
<!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.
org.eclipse.core.commands.IParameterValues
. Pokud tato třída není určena, musíte zadat podrobnější prvek values
. Viz org.eclipse.core.runtime.IExecutableExtension
.<!ATTLIST values
class CDATA #REQUIRED>
Podrobnější verze atributu values
na commandParameter
.
org.eclipse.core.commands.IParameterValues
. Pokud tato třída není určena, musíte zadat podrobnější prvek values
. Viz org.eclipse.core.runtime.IExecutableExtension
.<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
Možná hodnota parametru.
IExecutableExtension
.IExecutableExtension
.<!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
.
org.eclipse.core.commands.IHandler
.
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
.
Copyright (c) 2000, 2005 IBM Corporation a další.
Všechna práva vyhrazena.
Tento program a doprovodné materiály jsou zpřístupněny za podmínek licence Eclipse Public License
v1.0, která je součástí této distribuce a je k dispozici na adrese
http://www.eclipse.org/legal/epl-v10.html