Estructura MENUITEMINFOA (winuser.h)

Artículo
03/04/2024

Contiene información sobre un elemento de menú.

Sintaxis

typedef struct tagMENUITEMINFOA {
  UINT      cbSize;
  UINT      fMask;
  UINT      fType;
  UINT      fState;
  UINT      wID;
  HMENU     hSubMenu;
  HBITMAP   hbmpChecked;
  HBITMAP   hbmpUnchecked;
  ULONG_PTR dwItemData;
  LPSTR     dwTypeData;
  UINT      cch;
  HBITMAP   hbmpItem;
} MENUITEMINFOA, *LPMENUITEMINFOA;

Miembros

cbSize

Tipo: UINT

El tamaño de la estructura en bytes. El autor de la llamada debe establecer este miembro en sizeof(MENUITEMINFO).

fMask

Tipo: UINT

Indica los miembros que se van a recuperar o establecer. Este miembro puede ser uno o varios de los valores siguientes.

Valor	Significado
MIIM_BITMAP 0x00000080	Recupera o establece el miembro hbmpItem .
MIIM_CHECKMARKS 0x00000008	Recupera o establece los miembros hbmpChecked y hbmpUnchecked .
MIIM_DATA 0x00000020	Recupera o establece el miembro dwItemData .
MIIM_FTYPE 0x00000100	Recupera o establece el miembro fType .
MIIM_ID 0x00000002	Recupera o establece el miembro wID .
MIIM_STATE 0x00000001	Recupera o establece el miembro fState .
MIIM_STRING 0x00000040	Recupera o establece el miembro dwTypeData .
MIIM_SUBMENU 0x00000004	Recupera o establece el miembro hSubMenu .
MIIM_TYPE 0x00000010	Recupera o establece los miembros fType y dwTypeData . MIIM_TYPE se reemplaza por MIIM_BITMAP, MIIM_FTYPE y MIIM_STRING.

fType

Tipo: UINT

Tipo de elemento de menú. Este miembro puede ser uno o varios de los valores siguientes.

Los valores MFT_BITMAP, MFT_SEPARATOR y MFT_STRING no se pueden combinar entre sí. Establezca fMasken MIIM_TYPE para usar fType.

fType solo se usa si fMask tiene un valor de MIIM_FTYPE.

Valor	Significado
MFT_BITMAP 0x00000004L	Muestra el elemento de menú mediante un mapa de bits. La palabra de orden bajo del miembro dwTypeData es el identificador de mapa de bits y se omite el miembro cch . MFT_BITMAP se reemplaza por MIIM_BITMAP y hbmpItem.
MFT_MENUBARBREAK 0x00000020L	Places el elemento de menú en una nueva línea (para una barra de menús) o en una nueva columna (para un menú desplegable, submenú o menú contextual). Para un menú desplegable, submenú o menú contextual, una línea vertical separa la nueva columna de la antigua.
MFT_MENUBREAK 0x00000040L	Places el elemento de menú en una nueva línea (para una barra de menús) o en una nueva columna (para un menú desplegable, submenú o menú contextual). Para un menú desplegable, submenú o menú contextual, las columnas no están separadas por una línea vertical.
MFT_OWNERDRAW 0x00000100L	Asigna la responsabilidad de dibujar el elemento de menú en la ventana propietaria del menú. La ventana recibe un mensaje de WM_MEASUREITEM antes de que se muestre el menú por primera vez y un mensaje WM_DRAWITEM cada vez que se deba actualizar la apariencia del elemento de menú. Si se especifica este valor, el miembro dwTypeData contiene un valor definido por la aplicación.
MFT_RADIOCHECK 0x00000200L	Muestra los elementos de menú seleccionados mediante una marca de botón de radio en lugar de una marca de verificación si el miembro hbmpChecked es NULL.
MFT_RIGHTJUSTIFY 0x00004000L	Justifica con el botón derecho el elemento de menú y los elementos posteriores. Este valor solo es válido si el elemento de menú está en una barra de menús.
MFT_RIGHTORDER 0x00002000L	Especifica que los menús en cascada de derecha a izquierda (el valor predeterminado es de izquierda a derecha). Se usa para admitir idiomas de derecha a izquierda, como árabe y hebreo.
MFT_SEPARATOR 0x00000800L	Especifica que el elemento de menú es un separador. Un separador de elementos de menú aparece como una línea divisora horizontal. Se omiten los miembros dwTypeData y cch . Este valor solo es válido en un menú desplegable, submenú o menú contextual.
MFT_STRING 0x00000000L	Muestra el elemento de menú mediante una cadena de texto. El miembro dwTypeData es el puntero a una cadena terminada en null y el miembro cch es la longitud de la cadena. MFT_STRING se reemplaza por MIIM_STRING.

fState

Tipo: UINT

Estado del elemento de menú. Este miembro puede ser uno o varios de estos valores. Establezca fMasken MIIM_STATE para usar fState.

Valor	Significado
MFS_CHECKED 0x00000008L	Comprueba el elemento de menú. Para obtener más información sobre los elementos de menú seleccionados, vea el miembro hbmpChecked .
MFS_DEFAULT 0x00001000L	Especifica que el elemento de menú es el valor predeterminado. Un menú solo puede contener un elemento de menú predeterminado, que se muestra en negrita.
MFS_DISABLED 0x00000003L	Deshabilita el elemento de menú y lo grisiza para que no se pueda seleccionar. Esto equivale a MFS_GRAYED.
MFS_ENABLED 0x00000000L	Habilita el elemento de menú para que se pueda seleccionar. Este es el estado predeterminado.
MFS_GRAYED 0x00000003L	Deshabilita el elemento de menú y lo grisiza para que no se pueda seleccionar. Esto equivale a MFS_DISABLED.
MFS_HILITE 0x00000080L	Resalta el elemento de menú.
MFS_UNCHECKED 0x00000000L	Desactiva el elemento de menú. Para obtener más información sobre los elementos de menú no cifrados, vea el miembro hbmpChecked .
MFS_UNHILITE 0x00000000L	Quita el resaltado del elemento de menú. Este es el estado predeterminado.

wID

Tipo: UINT

Valor definido por la aplicación que identifica el elemento de menú. Establezca fMasken MIIM_ID para usar wID.

hSubMenu

Tipo: HMENU

Identificador del menú desplegable o submenú asociado al elemento de menú. Si el elemento de menú no es un elemento que abre un menú desplegable o submenú, este miembro es NULL. Establezca fMasken MIIM_SUBMENU para usar hSubMenu.

hbmpChecked

Tipo: HBITMAP

Identificador del mapa de bits que se mostrará junto al elemento si está seleccionado. Si este miembro es NULL, se usa un mapa de bits predeterminado. Si se especifica el valor de tipo MFT_RADIOCHECK , el mapa de bits predeterminado es una viñeta. De lo contrario, es una marca de verificación. Establezca fMasken MIIM_CHECKMARKS para usar hbmpChecked.

hbmpUnchecked

Tipo: HBITMAP

Identificador del mapa de bits que se mostrará junto al elemento si no está seleccionado. Si este miembro es NULL, no se usa ningún mapa de bits. Establezca fMasken MIIM_CHECKMARKS para usar hbmpUnchecked.

dwItemData

Tipo: ULONG_PTR

Valor definido por la aplicación asociado al elemento de menú. Establezca fMasken MIIM_DATA para usar dwItemData.

dwTypeData

Tipo: LPTSTR

Contenido del elemento de menú. El significado de este miembro depende del valor de fType y solo se usa si la marca MIIM_TYPE se establece en el miembro fMask .

Para recuperar un elemento de menú de tipo MFT_STRING, primero busque el tamaño de la cadena estableciendo el miembro dwTypeData de MENUITEMINFO en NULL y, a continuación, llamando a GetMenuItemInfo. El valor de cch+1 es el tamaño necesario. A continuación, asigne un búfer de este tamaño, coloque el puntero al búfer en dwTypeData, incremente cch y llame a GetMenuItemInfo una vez más para rellenar el búfer con la cadena. Si el elemento de menú recuperado es de algún otro tipo, GetMenuItemInfo establece el miembro dwTypeData en un valor cuyo tipo especifica el miembro fType .

Cuando se usa con la función SetMenuItemInfo , este miembro debe contener un valor cuyo tipo especifica el miembro fType .

dwTypeData solo se usa si la marca MIIM_STRING está establecida en el miembro fMask

cch

Tipo: UINT

Longitud del texto del elemento de menú, en caracteres, cuando se recibe información sobre un elemento de menú del tipo MFT_STRING . Sin embargo, cch solo se usa si la marca MIIM_TYPE se establece en el miembro fMask y es cero de lo contrario. Además, cch se omite cuando el contenido de un elemento de menú se establece mediante una llamada a SetMenuItemInfo.

Tenga en cuenta que, antes de llamar a GetMenuItemInfo, la aplicación debe establecer cch en la longitud del búfer al que apunta el miembro dwTypeData . Si el elemento de menú recuperado es de tipo MFT_STRING (como se indica en el miembro fType ), GetMenuItemInfo cambia cch a la longitud del texto del elemento de menú. Si el elemento de menú recuperado es de algún otro tipo, GetMenuItemInfo establece el campo cch en cero.

El miembro cch se usa cuando la marca MIIM_STRING se establece en el miembro fMask .

hbmpItem

Tipo: HBITMAP

Identificador del mapa de bits que se va a mostrar o puede ser uno de los valores de la tabla siguiente. Se usa cuando la marca MIIM_BITMAP se establece en el miembro fMask .

Valor	Significado
HBMMENU_CALLBACK ((HBITMAP) -1)	Mapa de bits dibujado por la ventana que posee el menú. La aplicación debe procesar los mensajes WM_MEASUREITEM y WM_DRAWITEM .
HBMMENU_MBAR_CLOSE ((HBITMAP) 5)	Botón Cerrar de la barra de menús.
HBMMENU_MBAR_CLOSE_D ((HBITMAP) 6)	Botón Cerrar deshabilitado para la barra de menús.
HBMMENU_MBAR_MINIMIZE ((HBITMAP) 3)	Minimice el botón de la barra de menús.
HBMMENU_MBAR_MINIMIZE_D ((HBITMAP) 7)	Deshabilitado el botón minimizar para la barra de menús.
HBMMENU_MBAR_RESTORE ((HBITMAP) 2)	Botón Restaurar de la barra de menús.
HBMMENU_POPUP_CLOSE ((HBITMAP) 8)	Cierre el botón del submenú.
HBMMENU_POPUP_MAXIMIZE ((HBITMAP) 10)	Botón Maximizar para el submenú.
HBMMENU_POPUP_MINIMIZE ((HBITMAP) 11)	Minimice el botón del submenú.
HBMMENU_POPUP_RESTORE ((HBITMAP) 9)	Botón Restaurar del submenú.
HBMMENU_SYSTEM ((HBITMAP) 1)	Icono de Windows o icono de la ventana especificada en dwItemData.

Comentarios

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

El menú puede mostrar elementos mediante texto, mapas de bits o ambos.

Nota

El encabezado winuser.h define MENUITEMINFO como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	winuser.h (incluya Windows.h)