UDF > GUI > GuiMenu >

_GUICtrlMenu_AppendMenu

Ajoute un nouvel �l�ment � la fin d'une barre de menu, dans un menu d�roulant, un sous-menu ou un raccourci sp�cifi�

#include <GuiMenu.au3>
_GUICtrlMenu_AppendMenu ( $hMenu, $iFlags, $iNewItem, $vNewItem )

Param�tres

$hMenu Handle du contr�le Menu
$iFlags D�finit les indicateurs qui contr�lent l'apparence et le comportement du nouveau �l�ment de menu:
    $MF_BITMAP - Utilise un bitmap comme �l�ment de menu
    $MF_CHECKED - Place une case coch�e � c�t� de l'�l�ment de menu. Si l'application fournit des bitmaps pour les cases coch�es, cet indicateur affiche le bitmap � c�t� de l'�l�ment de menu.
    $MF_DISABLED - D�sactive l'�l�ment de menu afin qu'il ne puisse pas �tre s�lectionn�, mais ne le grise pas.
    $MF_ENABLED - Active l'�l�ment de menu de sorte qu'il puisse �tre s�lectionn�, et le r�tablit de son �tat gris�.
    $MF_GRAYED - D�sactive l'�l�ment de menu et le grise pour qu'il ne puisse pas �tre s�lectionn�.
    $MF_MENUBARBREAK - Fonctionne comme $MF_MENUBREAK pour une barre de menu. Pour un menu d�roulant, un sous-menu, un raccourci, la nouvelle colonne est s�par�e de l'ancienne colonne par une ligne verticale.
    $MF_MENUBREAK - Place l'�l�ment sur une nouvelle ligne (pour une barre de menu) ou dans une nouvelle colonne (pour un menu d�roulant, un sous-menu ou un raccourci) sans colonnes de s�paration.
    $MF_OWNERDRAW - Indique que l'�l�ment g�re lui-m�me sa peinture.
        Avant que le menu soit affich� la premi�re fois, la fen�tre qui d�tient le menu re�oit un message $WM_MEASUREITEM pour r�cup�rer la largeur et la hauteur de l'�l�ment de menu.
        Le message $WM_DRAWITEM est ensuite envoy� � la fen�tre propri�taire chaque fois que l'apparence de l'�l�ment de menu doit �tre mis � jour.
    MF_POPUP - Indique que l'�l�ment de menu ouvre un menu d�roulant ou un sous-menu.
        Le param�tre $iNewItem sp�cifie un handle de menu d�roulant ou d'un sous-menu.
        Cet indicateur est utilis� pour ajouter un nom de menu � une barre de menu ou un �l�ment de menu qui ouvre un sous-menu � d�rouler, sous-menu ou un raccourci.
    $MF_SEPARATOR - Dessine une ligne de s�paration horizontale. Cet indicateur est utilis� uniquement dans un menu d�roulant, un sous-menu ou un raccourci.
        La ligne ne peut pas �tre gris�e, d�sactiv�e ou mise en surbrillance. Les param�tres $vNewitem et $iNewitem sont ignor�s.
    $MF_STRING - Indique que l'�l�ment de menu est une cha�ne de texte. Le param�tre $vNewitem est une cha�ne.
    $MF_UNCHECKED - Ne place pas une case coch�e � c�t� de l'�l�ment. Si l'application fournit des bitmaps pour les cases coch�es, cet indicateur affichera l'image bitmap d�coch� � c�t� de l'�l�ment de menu.
$iNewitem Indique l'identifiant du nouvel �l�ment de menu ou, si le param�tre $iFlags est d�fini � $MF_POPUP, le handle du menu d�roulant ou du sous-menu.
$vNewitem Indique le contenu du nouvel �l�ment de menu. L'interpr�tation de $vNewItem d�pend du param�tre $iFlags qui peut inclure ou pas les indicateurs $MF_BITMAP, $MF_OWNERDRAW, et $MF_STRING:
    $MF_BITMAP - Contient le handle du bitmap
    $MF_OWNERDRAW - Contient une valeur fournie par l'application qui peut �tre utilis� pour conserver des donn�es suppl�mentaires relatives � l'�l�ment de menu.
    La valeur est dans le membre ItemData de la structure point�e par le param�tre lParam du message envoy� $WM_MEASUREitem ou $WM_DRAWitem lorsque le menu est cr�� ou que son apparence est mise � jour.
    $MF_STRING - Contient une cha�ne

Valeur de retour

Succ�s: Retourne True.
�chec: Retourne False.

En relation

_GUICtrlMenu_InsertMenuItem

Voir aussi

Consultez AppendMenu dans la librairie MSDN.

Exemple

#include <GUIConstantsEx.au3>
#include <GuiMenu.au3>

Example()

Func Example()
    Local $hGUI, $hFile, $hEdit, $hHelp, $hMain
    Local Enum $e_idNew = 1000, $e_idOpen, $e_idSave, $e_idExit, $e_idCut, $e_idCopy, $e_idPaste, $e_idAbout

    ; Cr�e une GUI
    $hGUI = GUICreate("Menu", 400, 300)

    ; Cr�e un menu File
    $hFile = _GUICtrlMenu_CreateMenu()
    _GUICtrlMenu_InsertMenuItem($hFile, 0, "&New", $e_idNew)
    _GUICtrlMenu_InsertMenuItem($hFile, 1, "&Open", $e_idOpen)
    _GUICtrlMenu_InsertMenuItem($hFile, 2, "&Save", $e_idSave)
    _GUICtrlMenu_InsertMenuItem($hFile, 3, "", 0)
    _GUICtrlMenu_InsertMenuItem($hFile, 4, "E&xit", $e_idExit)

    ; Cr�e un menu Edit
    $hEdit = _GUICtrlMenu_CreateMenu()
    _GUICtrlMenu_InsertMenuItem($hEdit, 0, "&Cut", $e_idCut)
    _GUICtrlMenu_InsertMenuItem($hEdit, 1, "C&opy", $e_idCopy)
    _GUICtrlMenu_InsertMenuItem($hEdit, 2, "&Paste", $e_idPaste)

    ; Cr�e un menu Help
    $hHelp = _GUICtrlMenu_CreateMenu()

    ; Cr�e un menu Main
    $hMain = _GUICtrlMenu_CreateMenu()
    _GUICtrlMenu_InsertMenuItem($hMain, 0, "&File", 0, $hFile)
    _GUICtrlMenu_InsertMenuItem($hMain, 1, "&Edit", 0, $hEdit)
    _GUICtrlMenu_InsertMenuItem($hMain, 2, "&Help", 0, $hHelp)

    ; Attache le menu � la fen�tre
    _GUICtrlMenu_SetMenu($hGUI, $hMain)
    GUISetState(@SW_SHOW)

    ; Ajoute l'�l�ment de menu About
    _GUICtrlMenu_AppendMenu($hHelp, $MF_STRING, $e_idAbout, "&About")

    ; Boucle jusqu'� ce que l'utilisateur quitte.
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
EndFunc   ;==>Example