SetMenuItemBitmaps, fonction (winuser.h)

Article
08/28/2023

Associe la bitmap spécifiée à un élément de menu. Que l’élément de menu soit sélectionné ou effacé, le système affiche la bitmap appropriée en regard de l’élément de menu.

Syntaxe

BOOL SetMenuItemBitmaps(
  [in]           HMENU   hMenu,
  [in]           UINT    uPosition,
  [in]           UINT    uFlags,
  [in, optional] HBITMAP hBitmapUnchecked,
  [in, optional] HBITMAP hBitmapChecked
);

Paramètres

[in] hMenu

Type : HMENU

Handle du menu contenant l’élément pour recevoir de nouvelles bitmaps de marque case activée.

[in] uPosition

Type : UINT

Élément de menu à modifier, tel que déterminé par le paramètre uFlags .

[in] uFlags

Type : UINT

Spécifie comment le paramètre uPosition doit être interprété. Le paramètre uFlags doit avoir l’une des valeurs suivantes.

Valeur	Signification
MF_BYCOMMAND 0x00000000L	Indique que uPosition fournit l’identificateur de l’élément de menu. Si ni MF_BYCOMMAND ni MF_BYPOSITION n’est spécifié, MF_BYCOMMAND est l’indicateur par défaut.
MF_BYPOSITION 0x00000400L	Indique que uPosition donne la position relative de base zéro de l’élément de menu.

[in, optional] hBitmapUnchecked

Type : HBITMAP

Handle de la bitmap affichée lorsque l’élément de menu n’est pas sélectionné.

[in, optional] hBitmapChecked

Type : HBITMAP

Handle de la bitmap affichée lorsque l’élément de menu est sélectionné.

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

Si le paramètre hBitmapUnchecked ou hBitmapChecked a la valeur NULL, le système n’affiche rien en regard de l’élément de menu pour l’état case activée correspondant. Si les deux paramètres ont la valeur NULL, le système affiche la bitmap de marque de case activée par défaut lorsque l’élément est sélectionné et supprime la bitmap lorsque l’élément n’est pas sélectionné.

Lorsque le menu est détruit, ces bitmaps ne sont pas détruites ; c’est à l’application de les détruire.

Les bitmaps sélectionnées et en clair doivent être monochromes. Le système utilise l’opérateur Boolean AND pour combiner des bitmaps avec le menu afin que la partie blanche devienne transparente et que la partie noire devienne la couleur de l’élément de menu. Si vous utilisez des bitmaps de couleur, les résultats peuvent être indésirables.

Utilisez la fonction GetSystemMetrics avec les valeurs SM_CXMENUCHECK et SM_CYMENUCHECK pour récupérer les dimensions bitmap.

Exemples

Pour obtenir un exemple, consultez Simulation de cases à cocher dans un menu.

Spécifications


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

Menus

Partager via