Befehle
Kennung: org.eclipse.ui.commands
Verfügbar seit:
2.1
Beschreibung:
Am Erweiterungspunkt org.eclipse.ui.commands
werden unter Verwendung der Elemente command
und category
Befehle und Befehlskategorien deklariert. Über diesen Erweiterungspunkt können außerdem unter Verwendung des Elements keyBinding
Tastenkombinationen zu Befehlen zugeordnet werden. Tastenkombinationen sind an Befehle gebunden, die auf Tastenkonfigurationen und Geltungsbereichen basieren, und werden hier in den Elementen keyConfiguration
und scope
ebenfalls angegeben.
Konfigurationsbefehle:
<!ELEMENT extension (activeKeyConfiguration , category , command , keyBinding , keyConfiguration , scope)>
<!ATTLIST extension
id CDATA
#IMPLIED
name CDATA
#IMPLIED
point CDATA #REQUIRED
>
- id - Optionale ID des Erweiterungsexemplars.
- name - Optionaler Name des Erweiterungsexemplars.
- point - Vollständig qualifizierte ID des Zielerweiterungspunkts.
<!ELEMENT activeKeyConfiguration EMPTY>
Dieses Element definiert die anfänglich aktive Tastenkonfiguration für Eclipse.
Wenn mehrere solcher Elemente vorhanden sind, wird nur das als letztes deklarierte Element (in der Reihenfolge, in der die Plug-in-Registrierung gelesen wird) als gültig betrachtet.
<!ATTLIST activeKeyConfiguration
value CDATA #IMPLIED
>
- value - Die eindeutige ID (Attribut
id
) des Elements "keyConfiguration", das anfänglich aktiv sein soll.
<!ELEMENT category EMPTY>
In der Benutzerschnittstelle werden Befehle häufig in Kategorien angeordnet, um ihre Verwaltung zu vereinfachen. Dieses Element dient zum Definieren solcher Kategorien.
Befehle können sich selbst zu höchstens einer Kategorie zuordnen. Wenn mehrere solcher Elemente mit demselben Attribut id
vorhanden sind, wird nur das als letztes deklarierte Element (in der Reihenfolge, in der die Plug-in-Registrierung gelesen wird) als gültig betrachtet.
<!ATTLIST category
description CDATA #IMPLIED
id CDATA #REQUIRED
name CDATA #REQUIRED
>
- description - Eine übersetzbare kurze Beschreibung dieser Kategorie, die in der Benutzerschnittstelle angezeigt wird.
- id - Die eindeutige Kennung dieser Kategorie.
- name - Der übersetzbare Name dieser Kategorie, der in der Benutzerschnittstelle angezeigt wird.
<!ELEMENT command EMPTY>
Mit diesem Element werden Befehle definiert. Ein Befehl stellt eine Anforderung vom Benutzer dar, der durch eine Aktion verarbeitet werden kann, und sollte im Vergleich zu anderen Befehlen semantisch eindeutig sein.
Definieren Sie keinen Befehl, wenn es bereits einen Befehl gibt, der mit derselben Bedeutung definiert wurde.
Wenn mehrere solcher Elemente mit demselben Attribut id
vorhanden sind, wird nur das als letztes deklarierte Element (in der Reihenfolge, in der die Plug-in-Registrierung gelesen wird) als gültig betrachtet.
Informationen dazu, wie Aktionen mit Befehlen verbunden werden, finden Sie in den Angaben zu den Erweiterungspunktenorg.eclipse.ui.actionSets und org.eclipse.ui.editorActions.
<!ATTLIST command
category CDATA #IMPLIED
description CDATA #IMPLIED
icon CDATA #IMPLIED
id CDATA #REQUIRED
name CDATA #REQUIRED
>
- category - Die eindeutige ID für die Kategorie dieses Befehls. Wenn dieser Befehl keine Kategorie angibt, wird er trotzdem in allen Benutzerschnittstellen angezeigt, zusammen mit anderen speziell kategorisierten Befehlen.
- description - Eine übersetzbare kurze Beschreibung dieses Befehls, die in der Benutzerschnittstelle angezeigt wird.
- icon -
- id - Die eindeutige Kennung dieses Befehls.
- name - Der übersetzbare Name dieses Befehls, der in der Benutzerschnittstelle angezeigt wird. Befehle werden normalerweise mit dem Infinitiv eines Verbs benannt.
<!ELEMENT keyBinding EMPTY>
Mit diesem Element können Tastenkombinationen zu Befehlen zugeordnet werden.
<!ATTLIST keyBinding
configuration CDATA #REQUIRED
command CDATA #IMPLIED
locale CDATA #IMPLIED
platform CDATA #IMPLIED
scope CDATA #REQUIRED
string CDATA #REQUIRED
>
- configuration - Die eindeutige ID der Tastenkonfiguration für diese Tastenbelegung.
- command - Die eindeutige Kennung des Befehls, zu dem die Tastenkombination, die durch diese Tastenbelegung angegeben ist, zugeordnet wird.
Wenn der Wert dieses Attributs eine leere Zeichenfolge ist, wird die Tastenkombination einem internen Befehl "no operation" zugeordnet.
Dies ist hilfreich, um die Definition Tastenbelegungen in spezifischen Tastenkonfigurationen und Geltungsbereichen rückgängig zu machen, die möglicherweise von den übergeordneten Elementen übernommen worden.
- locale - Ein optionales Attribut, mit dem angegeben wird, dass diese Tastenbelegung nur für die angegebene Ländereinstellung definiert wird. Ländereinstellungen werden gemäß dem Format angegeben, das in
java.util.Locale
deklariert ist.
- platform - Ein optionales Attribut, mit dem angegeben wird, dass diese Tastenbelegung nur für die angegebene Plattform definiert wird. Die gültigen Wert für das Attribut
platform
sind die gültigen Werte, die durch org.eclipse.swt.SWT.getPlatform()
zurückgegeben werden.
- scope - Die eindeutige ID des Geltungsbereichs für diese Tastenbelegung.
- string - Die Tastenkombination, die dem Befehl zugeordnet werden soll. Tastenkombinationen bestehen aus einem oder mehreren Tastenanschlägen (ein Tastenanschlag gilt für eine Taste auf der Tastatur), die optional in Kombination mit einer oder mehreren der Änderungstasten Strg, Alt, Umschalttaste und Befehlstaste gedrückt werden.
Tastenanschläge werden durch Leerzeichen, Änderungstasten werden durch das Pluszeichen (+) voneinander getrennt.
<!ELEMENT keyConfiguration EMPTY>
Mit diesem Element werden Tastenkonfigurationen definiert. Wenn mehrere solcher Elemente mit demselben Attribut id
vorhanden sind, wird nur das als letztes deklarierte Element (in der Reihenfolge, in der die Plug-in-Registrierung gelesen wird) als gültig betrachtet.
<!ATTLIST keyConfiguration
description CDATA #IMPLIED
id CDATA #REQUIRED
name CDATA #REQUIRED
parent CDATA #IMPLIED
>
- description - Eine übersetzbare kurze Beschreibung dieser Tastenkonfiguration, die in der Benutzerschnittstelle angezeigt wird.
- id - Die eindeutige Kennung dieser Tastenkonfiguration.
- name - Der übersetzbare Name dieser Tastenkonfiguration, der in der Benutzerschnittstelle angezeigt wird. Wenn es für diese Tastenkonfiguration ein übergeordnetes Element gibt, ist es nicht erforderlich, die Angabe"(extends ...)" zum Namen hinzuzufügen. Dies wird bei Bedarf von der Benutzerschnittstelle automatisch ausgeführt.
- parent - Die eindeutige ID der übergeordneten Tastenkonfiguration. Wenn es für diese Tastenkonfiguration ein übergeordnetes Element gibt, übernimmt sie, zusätzlich zu den Tastenbelegungen, die in ihrer eigenen Tastenkonfiguration definiert sind, alle Tastenbelegungen aus ihrem übergeordneten Element.
<!ELEMENT scope EMPTY>
Mit diesem Element werden Geltungsbereiche definiert. Wenn mehrere solcher Elemente mit demselben Attribut id
vorhanden sind, wird nur das als letztes deklarierte Element (in der Reihenfolge, in der die Plug-in-Registrierung gelesen wird) als gültig betrachtet.
<!ATTLIST scope
description CDATA #IMPLIED
id CDATA #REQUIRED
name CDATA #REQUIRED
parent CDATA #IMPLIED
>
- description - Eine übersetzbare kurze Beschreibung dieses Geltungsbereichs, die in der Benutzerschnittstelle angezeigt wird.
- id - Die eindeutige Kennung dieses Geltungsbereichs.
- name - Der übersetzbare Name dieses Geltungsbereichs, der in der Benutzerschnittstelle angezeigt wird. Wenn es für diesen Geltungsbereich ein übergeordnetes Element gibt, ist es nicht erforderlich, die Angabe "(extends parent)" zum Namen hinzuzufügen. Dies wird bei Bedarf von der Benutzerschnittstelle automatisch ausgeführt.
- parent - Die eindeutige Kennung des übergeordneten Geltungsbereichs. Wenn es für diesen Geltungsbereich ein übergeordnetes Element gibt, übernimmt er, zusätzlich zu den Tastenbelegungen, die in seinem eigenen Geltungsbereich definiert sind, alle Tastenbelegungen aus seinem übergeordneten Element.
Beispiele:
Die Datei plugin.xml
im Plug-in org.eclipse.ui
setzt den Erweiterungspunkt org.eclipse.ui.commands
intensiv ein.
API-Informationen:
Für die Deklaration von Befehlen, Kategorien, Tastenbelegungen, Tastenkonfigurationen oder Geltungsbereichen gibt aus außer diesem Erweiterungspunkt keine öffentliche API.
Eine öffentliche API für das Abrufen und Festlegen von Geltungsbereichen sowie für die Registrierung von Aktionen zur Verarbeitung spezifischer Befehle finden Sie in org.eclipse.ui.IKeyBindingService
.
Copyright (c) 2000, 2003 IBM Corporation und Andere.
Alle Rechte vorbehalten. Dieses Programm und sein Begleitmaterial werden gemäß
den Bedingungen in der "Common Public License v1.0" zur Verfügung gestellt, die diese Verteilung
begleitet und unter
http://www.eclipse.org/legal/cpl-v10.html abgerufen werden kann.