Estructura MENUITEMINFOA (winuser.h)
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
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 siguientes valores.
fType
Tipo: UINT
Tipo de elemento de menú. Este miembro puede ser uno o varios de los siguientes valores.
Los valores MFT_BITMAP, MFT_SEPARATORy MFT_STRING no se pueden combinar entre sí. Establezca fMask en MIIM_TYPE para usar fType.
fType solo se usa si fMask tiene un valor de MIIM_FTYPE.
| Valor | Significado |
|---|---|
|
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. |
|
Coloca 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. |
|
Coloca 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. |
|
Asigna la responsabilidad de dibujar el elemento de menú en la ventana que posee el menú. La ventana recibe un mensaje de WM_MEASUREITEM antes de que se muestre el menú por primera vez y un mensaje de WM_DRAWITEM cada vez que se debe actualizar la apariencia del elemento de menú. Si se especifica este valor, el dwTypeData miembro contiene un valor definido por la aplicación. |
|
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 de hbmpChecked |
|
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. |
|
Especifica que los menús en cascada de derecha a izquierda (el valor predeterminado es de izquierda a derecha). Esto se usa para admitir idiomas de derecha a izquierda, como árabe y hebreo. |
|
Especifica que el elemento de menú es un separador. Un separador de elementos de menú aparece como una línea divisoria horizontal. Los miembros de dwTypeData y cch se omiten. Este valor solo es válido en un menú desplegable, submenú o menú contextual. |
|
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 fMask en MIIM_STATE para usar fState.
wID
Tipo: UINT
Valor definido por la aplicación que identifica el elemento de menú. Establezca fMask en MIIM_ID para usar wID.
hSubMenu
Tipo: HMENU de
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 fMask en MIIM_SUBMENU para usar hSubMenu.
hbmpChecked
Tipo: HBITMAP
Identificador del mapa de bits que se va a 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 fMask en MIIM_CHECKMARKS para usar hbmpChecked.
hbmpUnchecked
Tipo: HBITMAP
Identificador del mapa de bits que se va a mostrar junto al elemento si no está seleccionado. Si este miembro es NULL, no se usa ningún mapa de bits. Establezca fMask en MIIM_CHECKMARKS para usar hbmpUnchecked.
dwItemData
Tipo: ULONG_PTR
Valor definido por la aplicación asociado al elemento de menú. Establezca fMask en MIIM_DATA para usar dwItemData.
dwTypeData
Tipo: LPTSTR de
Contenido del elemento de menú. El significado de este miembro depende del valor de fType y solo se usa si la marca de MIIM_TYPE está establecida en el miembro fMask.
Para recuperar un elemento de menú de tipo
Cuando se usa con la función setMenuItemInfo de
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, solo se usa
Tenga en cuenta que, antes de llamar a
El miembro
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 de
| Valor | Significado |
|---|---|
|
Mapa de bits dibujado por la ventana que posee el menú. La aplicación debe procesar los mensajes WM_MEASUREITEM y WM_DRAWITEM. |
|
Cierre el botón de la barra de menús. |
|
Botón Cerrar deshabilitado para la barra de menús. |
|
Minimice el botón de la barra de menús. |
|
Deshabilitado el botón minimizar para la barra de menús. |
|
Botón Restaurar de la barra de menús. |
|
Cierre el botón del submenú. |
|
Botón Maximizar para el submenú. |
|
Minimice el botón para el submenú. |
|
Botón Restaurar para el submenú. |
|
Icono de Windows o el icono de la ventana especificada en dwItemData. |
Observaciones
La estructura MENUITEMINFO se usa con las funciones GetMenuItemInfo, InsertMenuItemy 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows 2000 Server [solo aplicaciones de escritorio] |
| encabezado de |
winuser.h (incluya Windows.h) |
Consulte también
conceptual de
menús de
de referencia de