Fonction HiliteMenuItem (winuser.h)

Article
08/27/2023

Ajoute ou supprime la mise en surbrillance d’un élément dans une barre de menus.

Syntaxe

BOOL HiliteMenuItem(
  [in] HWND  hWnd,
  [in] HMENU hMenu,
  [in] UINT  uIDHiliteItem,
  [in] UINT  uHilite
);

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre qui contient le menu.

[in] hMenu

Type : HMENU

Poignée de la barre de menus qui contient l’élément.

[in] uIDHiliteItem

Type : UINT

Élément de menu. Ce paramètre est soit l’identificateur de l’élément de menu, soit le décalage de l’élément de menu dans la barre de menus, en fonction de la valeur du paramètre uHilite .

[in] uHilite

Type : UINT

Contrôle l’interprétation du paramètre uItemHilite et indique si l’élément de menu est mis en surbrillance. Ce paramètre doit être une combinaison de MF_BYCOMMAND ou de MF_BYPOSITION et de MF_HILITE ou de MF_UNHILITE.

Valeur	Signification
MF_BYCOMMAND 0x000000000L	Indique que uItemHilite donne l’identificateur de l’élément de menu.
MF_BYPOSITION 0x000000400L	Indique que uItemHilite donne la position relative de base zéro de l’élément de menu.
MF_HILITE 0x000000080L	Met en surbrillance l’élément de menu. Si cet indicateur n’est pas spécifié, la mise en surbrillance est supprimée de l’élément.
MF_UNHILITE 0x000000000L	Supprime la mise en surbrillance de l’élément de menu.

Valeur retournée

Type : BOOL

Si l’élément de menu est défini sur l’état de surbrillance spécifié, la valeur de retour est différente de zéro.

Si l’élément de menu n’est pas défini sur l’état de surbrillance spécifié, la valeur de retour est zéro.

Remarques

Les indicateurs MF_HILITE et MF_UNHILITE ne peuvent être utilisés qu’avec la fonction HiliteMenuItem ; ils ne peuvent pas être utilisés avec la fonction ModifyMenu .

Configuration requise


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

Voir aussi

Conceptuel

Menus

ModifyMenu

Référence

Partager via