Función SetMenuItemBitmaps (winuser.h)

  • Artículo

Asocia el mapa de bits especificado a un elemento de menú. Si el elemento de menú está seleccionado o desactivado, el sistema muestra el mapa de bits adecuado junto al elemento de menú.

Sintaxis

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

Parámetros

[in] hMenu

Tipo: HMENU

Identificador del menú que contiene el elemento para recibir nuevos mapas de bits de marca de verificación.

[in] uPosition

Tipo: UINT

Elemento de menú que se va a cambiar, determinado por el parámetro uFlags .

[in] uFlags

Tipo: UINT

Especifica cómo se va a interpretar el parámetro uPosition . El parámetro uFlags debe ser uno de los valores siguientes.

Value Significado
MF_BYCOMMAND
0x00000000L
 Indica que uPosition proporciona el identificador del elemento de menú. Si no se especifica ni MF_BYCOMMAND ni MF_BYPOSITION , MF_BYCOMMAND es la marca predeterminada.
MF_BYPOSITION
0x00000400L
 Indica que uPosition proporciona la posición relativa de base cero del elemento de menú.

[in, optional] hBitmapUnchecked

Tipo: HBITMAP

Identificador del mapa de bits que se muestra cuando no se selecciona el elemento de menú.

[in, optional] hBitmapChecked

Tipo: HBITMAP

Identificador del mapa de bits que se muestra cuando se selecciona el elemento de menú.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Si el parámetro hBitmapUnchecked o hBitmapChecked es NULL, el sistema no muestra nada junto al elemento de menú para el estado de comprobación correspondiente. Si ambos parámetros son NULL, el sistema muestra el mapa de bits de marca de verificación predeterminado cuando se selecciona el elemento y quita el mapa de bits cuando el elemento no está seleccionado.

Cuando se destruye el menú, estos mapas de bits no se destruyen; corresponde a la aplicación destruirlos.

Los mapas de bits seleccionados y claros deben ser monocromáticos. El sistema usa el operador BOOLEAN AND para combinar mapas de bits con el menú para que la parte blanca se haga transparente y la parte negra se convierta en el color del elemento de menú. Si usa mapas de bits de color, es posible que los resultados no sean deseables.

Use la función GetSystemMetrics con los valores SM_CXMENUCHECK y SM_CYMENUCHECK para recuperar las dimensiones de mapa de bits.

Ejemplos

Para obtener un ejemplo, vea Simulación de casillas en un menú.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluir Windows.h)
Library User32.lib
Archivo DLL User32.dll

Consulte también

Menús