winuser.h


SetMenuItemBitmaps

La función SetMenuItemBitmaps asocia el mapa de bits especificado con un ítem de menú. Cada vez que el ítem de menú sea marcado o desmarcado, Windows muestra el mapa de bits apropiado junto al ítem de menú.

Sintaxis

BOOL SetMenuItemBitmaps(
    HMENU hMenu,               // manipulador de menú
    UINT uPosition,            // ítem de menú que recibe mapas de bits nuevos
    UINT uFlags,               // banderas de ítem de menú
    HBITMAP hBitmapUnchecked,  // manipulador a mapa de bits para no marcado
    HBITMAP hBitmapChecked     // manipulador a mapa de bits para marcado
   );

Parámetros

hMenu: identifica el menú que contiene el ítem que recibe los nuevos mapas de bits para marcas de chequeo.

uPosition: especifica el ítem de menú a cambiar, tal como determine el parámetro uFlags.

uFlags: especifica el modo en que se interpreta el parámetro uPosition. El parámetro uFlags debe ser uno de los siguientes valores:

Valor Significado
MF_BYCOMMAND Indica que el parámetro uPosition contiene el identificador del ítem de menú. La bandera MF_BYCOMMAND es el valor por defecto, si no se especifica ni MF_BYCOMMAND ni MF_BYPOSITION.
MF_BYPOSITION Indica que el parámetro uPosition contiene la posición relativa empezando en cero del ítem de menú.

hBitmapUnchecked: identifica el mapa de bits a mostrar cuando el ítem no esté marcado.

hBitmapChecked: identifica el mapa de bits a mostrar cuando el ítem esté marcado.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si la función falla, el valor de retorno es cero. Para obtener información adicional sobre el error, llamar a GetLastError.

Observaciones

Si el parámetro hBitmapUnchecked o hBitmapChecked es NULL, Windows no muestra nada junto al ítem de menú para el estado de chequeo correspondiente. Si ambos parámetros son NULL, Windows muestra el mapa de bits por defecto para la marca de chequeo cuando el ítem esté marcado y elimina el mapa de bits cuando el ítem no esté marcado.

Cuando el menú es destruido, estos mapas de bits no serán destruidos; destruirlos es responsabilidad de la aplicación.

Windows NT: la función GetMenuCheckMarkDimensions recupera las dimensiones de la marca de chequeo por defecto usada para ítems de menú. Estos valores se usan para determinar el tamaño apropiado para los mapas de bits suministrados por la aplicación.

Windows 95: GetMenuCheckMarkDimensions es obsoleta. Usar GetsystemMetrics con los valores CXMENUCHECK y CYMENUCHECK para recuperar las dimensiones del mapa de bits.