SetMenuItemBitmaps, fonction (winuser.h)

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.

[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

Voir aussi

Menus