SetMenu, fonction (winuser.h)

  • Article

Affecte un nouveau menu à la fenêtre spécifiée.

Syntaxe

BOOL SetMenu(
  [in]           HWND  hWnd,
  [in, optional] HMENU hMenu
);

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre à laquelle le menu doit être affecté.

[in, optional] hMenu

Type : HMENU

Handle du nouveau menu. Si ce paramètre a la valeur NULL, le menu actuel de la fenêtre est supprimé.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fenêtre est redessinée pour refléter le changement de menu. Un menu peut être affecté à n’importe quelle fenêtre qui n’est pas une fenêtre enfant.

La fonction SetMenu remplace le menu précédent, le cas échéant, mais elle ne le détruit pas. Une application doit appeler la fonction DestroyMenu pour accomplir cette tâche.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Ensemble d’API ext-ms-win-ntuser-menu-l1-1-3 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

Conceptuel

DestroyMenu

GetMenu

Menus

Référence