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
   >

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

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

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

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

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

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