Estructura MEASUREITEMSTRUCT (winuser.h)

Artículo
08/28/2023

Informa al sistema de las dimensiones de un elemento de menú o control dibujado por el propietario. Esto permite al sistema procesar la interacción del usuario con el control correctamente.

Sintaxis

typedef struct tagMEASUREITEMSTRUCT {
  UINT      CtlType;
  UINT      CtlID;
  UINT      itemID;
  UINT      itemWidth;
  UINT      itemHeight;
  ULONG_PTR itemData;
} MEASUREITEMSTRUCT, *PMEASUREITEMSTRUCT, *LPMEASUREITEMSTRUCT;

Miembros

CtlType

Tipo: UINT

Tipo de control. Este miembro puede ser uno de los valores que se muestran en la tabla siguiente.

Value	Significado
ODT_COMBOBOX	Cuadro combinado dibujado por el propietario
ODT_LISTBOX	Cuadro de lista dibujado por el propietario
ODT_LISTVIEW	Control de vista de lista de dibujo de propietario
ODT_MENU	Menú dibujado por el propietario

CtlID

Tipo: UINT

Identificador del cuadro combinado o cuadro de lista. Este miembro no se usa para un menú.

itemID

Tipo: UINT

Identificador de un elemento de menú o la posición de un cuadro de lista o elemento de cuadro combinado. Este valor se especifica para un cuadro de lista solo si tiene el estilo LBS_OWNERDRAWVARIABLE ; este valor solo se especifica para un cuadro combinado si tiene el estilo CBS_OWNERDRAWVARIABLE .

itemWidth

Tipo: UINT

Ancho, en píxeles, de un elemento de menú. Antes de volver del mensaje, el propietario del elemento de menú dibujado por el propietario debe rellenar este miembro.

itemHeight

Tipo: UINT

Alto, en píxeles, de un elemento individual en un cuadro de lista o un menú. Antes de devolver el mensaje, el propietario del cuadro combinado dibujado por el propietario, el cuadro de lista o el elemento de menú debe rellenar este miembro.

itemData

Tipo: ULONG_PTR

Valor definido por la aplicación asociado al elemento de menú. Para un control, este miembro especifica el valor asignado por última vez al cuadro de lista o cuadro combinado por el mensaje LB_SETITEMDATA o CB_SETITEMDATA . Si el cuadro de lista o el cuadro combinado tiene el estilo LB_HASSTRINGS o CB_HASSTRINGS, este valor es inicialmente cero. De lo contrario, este valor es inicialmente el valor pasado al cuadro de lista o al cuadro combinado en el parámetro lParam de uno de los mensajes siguientes:

Observaciones

La ventana propietaria de un control dibujado por el propietario recibe un puntero a la estructura MEASUREITEMSTRUCT como el parámetro lParam de un mensaje de WM_MEASUREITEM . El control dibujado por el propietario envía este mensaje a su ventana de propietario cuando se crea el control. A continuación, el propietario rellena los miembros adecuados en la estructura del control y devuelve. Esta estructura es común a todos los controles dibujados por el propietario, excepto el control de botón dibujado por el propietario cuyo tamaño está predeterminado por su ventana.

Si una aplicación no rellena los miembros adecuados de MEASUREITEMSTRUCT, es posible que el control o el elemento de menú no se dibujen correctamente.

Requisitos


Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	winuser.h (incluir Windows.h)