MenuItem()

Syntaxe

MenuItem(Element, Texte$ [, ImageID])

Crée une nouvelle entrée dans le menu en cours de construction. 'Element' est un numéro qui sera retourné par la commande EventMenu() si cet élément venait à être sélectionné. Dans la chaîne Texte$, vous pouvez utiliser le caractère & pour souligner une lettre spécifique :

"&Fichier" s'affichera ainsi : Fichier.

Si vous désirez associer un raccourci clavier (qui sera créé avec la commande AddKeyboardShortcut()) aligné sur le côté droit du menu (par exemple, "Save 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() avec le nombre 9 comme indiqué ci-dessous:

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

'ImageID' est facultatif et spécifie l'image qui sera affiché pour cet élément. Le menu doit avoir été créé avec CreateImageMenu() ou CreatePopupImageMenu(). 'ImageID' peut être facilement obtenu avec ImageID() de la bibliothèque Image.

Exemple:

  ;Note : Sous Windows XP, 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

MacOS X : 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 OS X. 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.

OS Supportés

Tous