MenuItem()

Syntax

MenuItem(MenuItemID, Text$ [, ImageID])

Erstellt einen neuen Menü-Eintrag im aktuellen Menü.

Parameter

MenuItemID	Die Nummer, mit der dieser Menü-Eintrag bei Ereignissen und bei Befehlen wie SetMenuItemState() identifiziert wird. Dieser Wert sollte zwischen 0 und 65535 liegen.
Text$	Der Text des Menü-Eintrags. Auf Windows können Sie im Text$ das Sonderzeichen '&' benutzen, um einen bestimmten Buchstaben zu unterstreichen: "&Datei" wird im Menü dann wie folgt angezeigt: Datei
ImageID (optional)	Das Bild (Image), welches nahe des Menü-Eintrags angezeigt werden soll. Das Menü muss mit CreateImageMenu() oder CreatePopupImageMenu() erstellt worden sein. Dieser Wert kann mit der ImageID() Funktion ermittelt werden.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Anmerkungen

Die Abmessungen der Bilder sind 16x16 Pixel.

Um ein Tastenkürzel (wird mit dem Befehl AddKeyboardShortcut() aktiviert, außer auf OS X) auf der rechten Seite des Menüeintrags (z.B. "Speichern Strg+S") darzustellen, verwenden Sie das TAB(ulator)-Zeichen für den richtigen Abstand. Das TAB-Zeichen hat den ASCII-Code 9, verwenden Sie daher den Befehl Chr() mit dem Wert 9 zum Einfügen eines TAB-Zeichens. Ihr Code sollte z.B. so aussehen:

  MenuItem(1, "&Open" + Chr(9) + "Strg+O")

Die unterstützten Zusatztasten sind:

  - "Ctrl"  : Ctrl-/Strg-Taste
  - "Shift" : Shift-/Umschalt-Taste
  - "Alt"   : Alt-Taste
  - "Cmd"   : Command/Apple-Taste (nur auf macOS)

Sie können mit Hilfe des "+" Zeichens miteinander gemixt werden: "Speichern als" + Chr(9) + "Ctrl+Shift+S". Auf macOS ist es - wenn ein Tastenkürzel im Menü erstellt wird - nicht erforderlich, die AddKeyboardShortcut() Funktion mit diesem Kürzel aufzurufen.

macOS: die Einträge 'Quit' (Ende), 'Preferences' (Einstellungen) und 'About' (Über) werden als spezielle Menü-Einträge behandelt und müssen im 'Application' (Anwendung) Menü platziert werden, um das Look & Feel von macOS Anwendungen zu erhalten. PureBasic unterstützt die #PB_Menu_Quit, #PB_Menu_Preferences und #PB_Menu_About Konstanten (müssen als 'MenuItemID' angegeben werden) für diese Art von Menü-Einträgen. Wenn eine dieser Konstanten festgestellt wird, dann wird der Eintrag nicht am aktuellen Platz, sondern im 'Application'-Menü eingefügt. Wenn ein Tastenkürzel angegeben wurde, wird dies einfach ignoriert und durch ein standardmäßiges ersetzt. Diese drei Konstanten sind nicht auf anderen OS definiert, um ein flexibles Nummerieren auf diesen OS zu ermöglichen.

Beispiel

  If OpenWindow(0, 200, 200, 200, 100, "MenuItem Example")
    If CreateMenu(0, WindowID(0))
      MenuTitle("Project")
        MenuItem(1, "Open")    ; normaler Eintrag
        MenuItem(2, "&Save")   ; Eintrag mit unterstrichenem Zeichen, die Unterstreichung wird jedoch
                               ; nur angezeigt, wenn das Menü mit F10 + den Cursor-Tasten aufgerufen wird
        MenuItem(3, "Quit"+Chr(9)+"Esc")   ; Eintrag mit separatem Text als Tastenkürzel
    EndIf
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Siehe auch

MenuTitle(), MenuBar(), OpenSubMenu()

Unterstützte OS

Alle