expansion of eclipse-menu/of toolbar under use of commands (from Eclipse 3.3)

The creation of menues and toolbars is almost identical and therefore, it will be explained together.

In the example, a font with the menu item Tahoma 10 shall be created above a menu:

1. open fragment.xml or plugin.xml and choose Register Extensions.
2. if not available yet, add extension-point org.eclipse.ui.menus with <Add>.
3. click with the right mouse button on the extension-point and choose New/menuContribution.
4. As locationURI enter for menus menu:org.eclipse.ui.main.menu?after=additions or rather for toolbar menu:org.eclipse.ui.main.toolbar?after=additions.
5. click on menu:org.eclipse.ui.main.menu?after=additions with the right mouse button and choose New/menu or rather New/toolbar.
6. enter the term of the menu (font) on the right in the array label.
7. now, click on the new menu on the left with the right mouse button and choose New/command.
8. on the right, fill in the commandId (e.g. com.sowas.demo.tahoma10) and the label (Tahoma 10).
9. Falls noch nicht vorhanden den Extension-Point org.eclipse.ui.commands mit <Add> hinzufügen.
10. Mit der rechten Maustaste auf den Extension-Point klicken und New/command wählen.
11. Rechts im Feld commandId die bereits unter Punkt 8 verwendete commandId (com.sowas.demo.tahoma10) eingeben.
12. Als name den Menüpunktnamen eingeben.
13. Nun auf Defaulthandler klicken und einen neuen Handler erstellen. Der Handler ist die Methode, welche aufgerufen wird, wenn der Benutzer den Menüpunkt anklickt. Die Methode muss das Interface IHandler implementieren.

Im Beispiel soll dem oben erstellten Menü Schrift das Untermenü Schriftart mit den Menüpunkten Tahoma und Verdana hinzugefügt werden:

1. Die Schritte 1 - 6 von oben durchführen.
2. Links das Menü Schrift mit der rechten Maustaste anklicken und New/menu wählen.
3. Rechts im Feld label die Bezeichnung des Untermenüs (hier: Schriftart) eingeben.
4. Nun links das neue Untermenü mit der rechten Maustaste anklicken und New/command wählen.
5. Rechts eine CommandId (z.B.: com.sowas.demo.changefont) eingeben.
6. Rechts als Label den Menüpunkt (Tahoma) eingeben.
7. Nun nochmals links das neue Untermenü mit der rechten Maustaste anklicken und New/command wählen.
8. Rechts wieder die CommandId (com.sowas.demo.changefont) eingeben.
9. Und rechts ebenfals als Label den Menüpunkt (Verdana) eingeben.
10. Nun links die Extension org.eclipse.ui.commands mit der rechten Maustaste anklicken.
11. Rechts die commandId (com.sowas.demo.changefont) und name (ChangeFont) ausfüllen.
12. Nun auf Defaulthandler klicken und einen Handler (z.B.: com.sowas.demo.ChangeFontHandler) erstellen. Der Handler ist die Methode, welche aufgerufen wird, wenn der Benutzer den Menüpunkt anklickt. Die Methode muss das Interface IHandler implementieren.
13. Links mit der rechten Maustaste auf ChangeFont klicken und New/commandParameter klicken
14. Rechts als id com.sowas.demo.schriftart eingeben.
15. Als name Schriftart eingeben.
16. Im Falle mehrerer Parameter optional auf true setzen.

Wird ein Menüpunkt nicht angezeigt, so ist in der Regel die Ursache, dass der Handler nicht gefunden wird.