Menüs, Symbolleisten und Aktionen in Sichten

Kennung: org.eclipse.ui.viewActions

Beschreibung: An diesem Erweiterungspunkt können Aktionen zu den Menü- und Symbolleisten von Sichten hinzugefügt werden, die durch andere Plug-ins definiert werden. Jede Sicht enthält ein lokales Pull-down-Menü, das normalerweise durch Klicken auf den rechten oberen Bereich aktiviert wird. Andere Plug-ins können dieses Menü durch Untermenüs und Aktionen ergänzen. Auch die Symbolleiste einer Sicht kann von Plug-ins durch Aktionen ergänzt werden. Zuerst erhält der Eigner der Sicht die Möglichkeit, diese Bereiche zu belegen. Optionale Zusätze durch andere Plug-ins werden angehängt.

Konfigurationsbefehle:

   <!ELEMENT viewContribution (menu | action)*>
   <!ATTLIST viewContribution
      id         CDATA #REQUIRED
      targetID   CDATA #REQUIRED
   >

  • id - Eine eindeutige Kennung, mit der auf diese Ergänzung verwiesen werden kann.
  • targetID: Die eindeutige Kennung der Sicht (wie in der Registrierung angegeben), die ergänzt werden soll.
  •    <!ELEMENT menu (separator)+>
       <!ATTLIST menu
          id         CDATA #REQUIRED
          label      CDATA #REQUIRED
          path       CDATA #IMPLIED
       >    <!ELEMENT separator EMPTY>
       <!ATTLIST separator
          name       CDATA #REQUIRED
       >
  • name: Der Name des Trennzeichens, auf das später als letztes Token im Aktionspfad verwiesen werden kann. Trennzeichen dienen daher als benannte Gruppen, in denen Aktionen hinzugefügt werden können.
  •    <!ELEMENT action (selection)*>
       <!ATTLIST action
          id                NMTOKEN #REQUIRED
          label             CDATA #REQUIRED
          menubarPath       CDATA #IMPLIED
          toolbarPath       CDATA #IMPLIED
          icon              CDATA #IMPLIED
          tooltip           CDATA #IMPLIED
          helpContextId     CDATA #IMPLIED
          state             (true | false) #IMPLIED
          class             CDATA #REQUIRED
          enablesFor        CDATA #IMPLIED
       >    <!ELEMENT selection EMPTY>
       <!ATTLIST selection
          class             CDATA #REQUIRED
          name              CDATA #IMPLIED
       > Die in der Anfangseinstellung geltenden Aktivierungskriterien für eine Aktionserweiterung werden durch enablesFor und selection definiert. Sobald die Aktionsdelegierung jedoch als Exemplar erstellt wurde, kann sie den Aktivierungsstatus einer Aktion direkt in ihrer Methode selectionChanged steuern.

    Aktions- und Menübezeichnungen können Sonderzeichen enthalten, die mnemonische Zeichen und Direktaufrufzeichen gemäß den folgenden Regeln codieren:

    1. Mnemonische Zeichen werden angegeben, indem ein Et-Zeichen (&) vor das mnemonische Zeichen des übersetzbaren Textes gesetzt wird. Da das Et-Zeichen in XML-Zeichenfolgen nicht zulässig ist, muss die Zeichenentität &amp; verwendet werden.
    2. Optionale Direktaufrufzeichen werden am Ende der Namenszeichenfolge mit dem Zeichen @ angegeben, auf das eine Reihe von Änderungswerten und das eigentliche Direktaufrufzeichen folgen (Beispiel: &amp;Speichern@Strg+S). Änderungswerte können mit dem Zeichen + als Begrenzer verkettet werden (Beispiel. @Strg+Umschalt+S).
    Beispiele:

    Im Folgenden ist ein Beispiel eines Erweiterungspunkts für Sichtaktionen dargestellt (bitte achten Sie insbesondere darauf, wie Unterelemente und Attribute verwendet werden):

       <extension point="org.eclipse.ui.viewActions">
          <viewContribution
             id="com.xyz.xyzViewC1"
             targetID="org.eclipse.ui.views.navigator.ResourceNavigator">
             <menu id="com.xyz.xyzMenu"
                label="XYZ Menu"
                path="additions">
                <separator name="group1"/>
             </menu>
             <action id="com.xyz.runXYZ"
                  label="&amp;Run XYZ Tool"
                  menubarPath="com.xyz.xyzMenu/group1"
                  toolbarPath="Normal/XYZ"
                  icon="icons/runXYZ.gif"
                  tooltip="Run XYZ Tool"
                  helpContextId="com.xyz.run_action_context"
                  class="com.xyz.actions.RunXYZ"
                  enablesFor="1"/>
                  <selection class="org.eclipse.core.resources.IFile" name="*.java">
             </action>
         </viewContribution>
       </extension>

    Im oben dargestellten Beispiel wird die angegebene Aktion nur bei einer Einzelauswahl aktiviert (Attribut enablesFor). Außerdem muss jedes Objekt in dieser Auswahl die angegebene Schnittstelle (IFile) implementieren und eine Java-Datei sein. Es können mehrere Elemente selection angegeben werden. Dann muss eine der Angaben vorliegen.

    API-Informationen: Der Wert des Attributs class muss der vollständig qualifizierte Name einer Java-Klasse sein, die org.eclipse.ui.IViewActionDelegate implementiert. Diese Schnittstelle wird so spät wie möglich geladen, um ein Laden des Plug-ins zu verhindern, bevor es wirklich benötigt wird. Sie erweitert org.eclipse.ui.IActionDelegate und fügt eine zusätzliche Methode hinzu, mit deren Hilfe die Delegierung mit dem Exemplar der Sicht initialisiert werden kann, für die Ergänzungen bereitgestellt werden.

    Bereitgestellte Implementierung: Jede Sicht enthält bei Auslieferung eine Reihe von Standardoptionen im Pull-down-Menü und der lokalen Symbolleiste. Zusätze aus anderen Plug-ins werden an die Standardelemente angehängt. Es ist hilfreich, die Aktionskennungen für eine Sicht in einer öffentlichen Schnittstelle zu publizieren. Die Aktionen und Hauptgruppen für das Workbench-Fenster sind beispielweise in der Schnittstelle "org.eclipse.ui.IWorkbenchActionConstants" definiert.

    Copyright IBM Corp. 2000, 2001. Alle Rechte vorbehalten.