MenuItem()

Syntax

MenuItem(MenuItemID, Text$ [, ImageID])
Beschreibung
Erstellt einen neuen Menü-Eintrag für das mittels 'MenuItemID' spezifierte Menü. Im Text$ können Sie das Sonderzeichen '&' benutzen, um einen bestimmten Buchstaben zu unterstreichen:

"&Datei" wird im Menü dann wie folgt angezeigt: Datei

Um ein Tastenkürzel (wird mit dem Befehl AddKeyboardShortcut() aktiviert) 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")
'ImageID' ist optional und definiert, welches Bild für diesen Menü-Eintrag verwendet wird. Das Menü muss mit CreateImageMenu() oder CreatePopupImageMenu() erstellt worden sein. 'ImageID' kann mit der ImageID() Funktion aus der Image Library ermittelt werden.

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 den F10 + Cursor-Tasten aufgerufen wird
        MenuItem(3, "Quit"+Chr(9)+"Esc")   ; Eintrag mit separatem Text für Tastenkürzel
    EndIf
    Repeat : Until WaitWindowEvent()=#PB_Event_CloseWindow
  EndIf
MacOS X: die Einträge 'Quit' (Ende), 'Preferences' (Einstellungen) und 'About' (Über) werden als spezielle Menü-Eintrage behandelt und müssen im 'Application' (Anwendung) Menü platziert werden, um das Look & Feel von OS X 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 'Applikation'-Menü eingefügt. Wenn einen 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.

Unterstützte OS

Alle

<- MenuID() - Menu Inhaltsverzeichnis - MenuTitle() ->