MenuItem()

Syntaxe

MenuItem(ElementID, Texte$ [, ImageID])
Description
Crée une nouvelle entrée dans un menu.

Arguments

ElementID Le numéro d'identification de la nouvelle entrée du menu.

Ce numéro sera utilisé dans les évènements Menu et renvoyé par EventMenu(), utilisé aussi dans certaines commande comme SetMenuItemState().

Cette valeur doit être entre 0 et 65535.
Texte$ Le texte de l'élément.

Sous Windows, vous pouvez utiliser le caractère '&' pour souligner une lettre :

"&Fichier" s'affichera ainsi : Fichier.
ImageID (optionnel) L'image qui sera affichée pour cet élément.
Le menu doit avoir été créé avec CreateImageMenu() ou CreatePopupImageMenu().

'ImageID' peut être facilement obtenu avec ImageID().

Valeur de retour

Aucune.

Remarques

Les dimensions des images sont de 16x16 pixels.

Si vous désirez associer un raccourci clavier (qui sera créé avec la commande AddKeyboardShortcut(), sauf sous MacOS) aligné sur le côté droit du menu (par exemple, "Sauvegarder Ctrl+S") alors vous pouvez utiliser le caractère 'tabulation' pour donner l'espacement correct. Le caractère 'Tabulation' a le code ASCII 9, donc il faudra utiliser la commande Chr(9) comme indiqué ci-dessous:
  MenuItem(1, "&Ouvrir" + Chr(9) + "Ctrl+O")
Les raccourcis supportés sont:
  - "Ctrl"  : touche 'Contrôle'
  - "Shift" : touche 'Majuscule'
  - "Alt"   : touche 'Alt'
  - "Cmd"   : touche 'Commande/Pomme' (MacOS seulement)
Ils peuvent être combinés entre eux à l'aide du caractère "+": "Enregistrer sous" + Chr(9) + "Ctrl+Shift+S".
Sous MacOS, quand un raccourci est défini dans le menu, il n'est pas nécessaire de le redéclarer à l'aide de la fonction AddKeyboardShortcut().

MacOS : les éléments 'Quitter', 'Préférences' et 'A propos' sont considérés comme spéciaux et doivent être placés dans le menu 'Application' pour avoir l'apparence et le comportement des applications MacOS. PureBasic fournit les constantes #PB_Menu_Quit, #PB_Menu_Preferences et #PB_Menu_About pour gérer ce genre d'éléments de menu. Lorsqu'une de ces constantes est détectée, l'élément n'est pas inséré à la place courante, mais dans le menu 'Application'. Si un raccourci a été associé, il est simplement ignoré et remplacé par le raccourci standard. Ces 3 constantes ne sont pas définies sur les autres systèmes d'exploitation, afin de permettre une numérotation flexible sur ces OS.

Exemple

  ;Note : Sous Windows XP et suivant, pour que le trait souligné apparaisse en permanence, 
  ;décochez l'option : 'Masquer les lettres soulignées pour la navigation au clavier jusqu'à ce que j'appuie sur la touche Alt'
  ;dans les propriétés du bureau puis affichage / Apparence / Effets.

  If OpenWindow(0, 200, 200, 200, 100, "Exemple MenuItem")
    If CreateMenu(0, WindowID(0))
      MenuTitle("Projet")
        MenuItem(1, "Ouvrir")        ; Elément normal
        MenuItem(2, "&Enregistrer")  ; Elément avec une lettre soulignée.
                                     ; Le trait souligné n'apparaîtra que si le menu est appelé avec F10 ou ALT.
        MenuItem(3, "Quitter"+Chr(9)+"ECHAP")  ; Elément avec un raccourci clavier affiché sur la droite.
    EndIf
    Repeat : Until WaitWindowEvent()=#PB_Event_CloseWindow
  EndIf

Voir aussi

MenuTitle(), MenuBar(), OpenSubMenu()

OS Supportés

Tous

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