Estructura MENUITEMINFO

Definición

typedef struct tagMENUITEMINFO {
    UINT    cbSize;  
    UINT    fMask; 
    UINT    fType; 
    UINT    fState; 
    UINT    wID; 
    HMENU   hSubMenu; 
    HBITMAP hbmpChecked; 
    HBITMAP hbmpUnchecked; 
    DWORD   dwItemData; 
    LPTSTR  dwTypeData; 
    UINT    cch; 
#if (_WIN32_WINNT >= 0x0500)
    HBITMAP hbmpItem;
#endif
} MENUITEMINFO, FAR *LPMENUITEMINFO; 

La estructura MENUITEMINFO contiene información sobre un ítem de menú.

Descripción

cbSize: tamaño de la estructura, en bytes.

fMask: miembros a recuperar o asignar. Este miembro puede ser uno o más de estos valores:

fType: tipo de ítem de menú. Este miembro puede ser uno o más de los siguientes valores:

Asignar el valor MIIM_TYPE a fMask para usar fType.

Windows 98/Me y Windows 2000/XP: fType se usa sólo si fMask tiene el valor MIIM_FTYPE.

Los valores MFT_BITMAP, MFT_SEPARATOR y MFT_STRING no pueden ser combinados con ningún otro.

fState: estado del ítem de menú. Asignar MIIM_STATE a fMask para usar fState. Este miembro puede ser uno o más de estos valores:

wID: valor de 16 bits definido por la aplicación que identifica el ítem de menú. Asignar MIIM_ID a fMask para usar wID.

hSubMenu: manipulador a menú desplegable o submenú asociado con el ítem de menú. Si el ítem de menú no es un ítem que abre un menú desplegable o submenú, este miembro es NULL. Asignar MIIM_SUBMENU a fMask para usar hSubMenu.

hbmpChecked: manipulador al mapa de bits a mostrar junto al ítem si está marcadod. Si este miembro es NULL, se usa el mapa de bits por defecto. Si se especifica el valor de tipo MFT_RADIOCHECK, el mapa de bits por defecto es el círculo. En otro caso, es la marca de verificación. Asignar MIIM_CHECKMARKS a fMask para usar hbmpChecked.

hbmpUnchecked: manipulador al mapa de bits a mostrar junto al ítem si no está marcado. Si este miembro es NULL, no se usa mapa de bits.

dwItemData: valor definido por la aplicación asociado con el ítem de menú. Asignar MIIM_DATA a fMask para usar dwItemData.

dwTypeData: contenido del ítem de menú. El significado de este miembro depende del tipo de ítem de menú: los valores MFT_BITMAP, MFT_SEPARATOR o MFT_STRING; y se usa sólo si se activa la bandera MIIM_TYPE en el miembro fMask.

Para recuperar un ítem de menú de tipo MFT_STRING, primero calcular el tamaño de la cadena asignado NULL al miembro dwTypeData de MENUITEMINFO y llamando a GetMenuItemInfo. El valor de cch+1 es el tamaño necesario. Entonces reservar la memoria necesaria en un búfer, colocar el puntero al búfer en dwTypeData, incrementar cch y llamar a GetMenuItemInfo una vez más para rellenar el búfer con la cadena. Si el ítem de menú a recuperar es de otro tipo, entonce GetMenuItemInfo asigna al miembro dwTypeData el valor adecuado según el valor especificado por el miembro fType.

Cuando se usa con la función SetMenuItemInfo, este miembro suele contener un tipo de valor que se especifica en el miembro fType.

Windows 98/Me y Windows 2000/XP: dwTypeData sólo se usa si el meimbro fMask vale MIIM_STRING.

cch: longitud del texto del ítem de menú, cuando se recibe información sobre el ítem de menú del tipo MFT_STRING. Este valor es cero para otros tipos de ítems de menú. Este miembro se ignora cuando el contenido del ítem de menú es asignado.

Hay que tener en cuenta que antes de llamar a GetMenuItemInfo, la aplicación debe asignar al miembro cch la longitud del búfer apuntado por el miembro dwTypeData. Si el ítem de menú a recuperar es de tipo MFT_STRING (como se indica en el miembro fType), entonces GetMenuItemInfo cambia el valor de cch a la longitud del texto del ítem de menú. Si el ítem de menú a recuperar es de algún otro tipo, GetMenuItemInfo asigna cero al campo cch.

Windows 98/Me, Windows 2000/XP: el meimbro cch se usa cuando se asigna MIIM_STRING al miembro fMask.

hbmpItem: Windows 98/Me, Windows 2000/XP. Manipulador de mapa de bits a mostrar, o puede ser uno de los valores de la siguiente tabla. Se usa si el miembro fMask contiene el valor MIIM_BITMAP.

Observaciones

La estructura MENUITEMINFO se usa con las funciones GetMenuItemInfo, InsertMenuItem y SetMenuItemInfo.