Estructura DRAWITEMSTRUCT (winuser.h)

Artículo
03/15/2023

Proporciona información que usa la ventana del propietario para determinar cómo pintar un elemento de menú o control dibujado por el propietario. La ventana propietaria del elemento de menú o control dibujado por el propietario recibe un puntero a esta estructura como el parámetro lParam del mensaje WM_DRAWITEM .

Sintaxis

typedef struct tagDRAWITEMSTRUCT {
  UINT      CtlType;
  UINT      CtlID;
  UINT      itemID;
  UINT      itemAction;
  UINT      itemState;
  HWND      hwndItem;
  HDC       hDC;
  RECT      rcItem;
  ULONG_PTR itemData;
} DRAWITEMSTRUCT, *PDRAWITEMSTRUCT, *LPDRAWITEMSTRUCT;

Miembros

CtlType

Tipo: UINT

Tipo de control. Este miembro puede ser uno de los valores siguientes. Vea la sección Comentarios.

Valor	Significado
ODT_BUTTON	Botón dibujado por el propietario
ODT_COMBOBOX	Cuadro combinado dibujado por el propietario
ODT_LISTBOX	Cuadro de lista dibujado por el propietario
ODT_LISTVIEW	Control de vista de lista
ODT_MENU	Elemento de menú dibujado por el propietario
ODT_STATIC	Control estático dibujado por el propietario
ODT_TAB	Control Tab

CtlID

Tipo: UINT

Identificador del cuadro combinado, cuadro de lista, botón o control estático. Este miembro no se usa para un elemento de menú.

itemID

Tipo: UINT

Identificador de elemento de menú para un elemento de menú o el índice del elemento en un cuadro de lista o cuadro combinado. Para un cuadro de lista vacío o un cuadro combinado, este miembro puede ser -1. Esto permite que la aplicación dibuje solo el rectángulo de foco en las coordenadas especificadas por el miembro rcItem aunque no haya elementos en el control. Esto indica al usuario si el cuadro de lista o el cuadro combinado tienen el foco. La forma en que se establecen los bits en el miembro itemAction determina si el rectángulo se va a dibujar como si el cuadro de lista o el cuadro combinado tengan el foco.

itemAction

Tipo: UINT

La acción de dibujo necesaria. Este miembro puede ser uno o varios de los valores.

Valor	Significado
ODA_DRAWENTIRE	Es necesario dibujar todo el control.
ODA_FOCUS	El control ha perdido o obtenido el foco del teclado. El miembro itemState debe comprobarse para determinar si el control tiene el foco.
ODA_SELECT	El estado de selección ha cambiado. El miembro itemState debe comprobarse para determinar el nuevo estado de selección.

itemState

Tipo: UINT

El estado visual del elemento después de que la acción de dibujo actual haya tenido lugar. Este miembro puede ser una combinación de los valores que se muestran en la tabla siguiente.

Valor	Significado
ODS_CHECKED	El elemento de menú se va a comprobar. Este bit sólo se usa en un menú.
ODS_COMBOBOXEDIT	El dibujo tiene lugar en el campo de selección (control de edición) de un cuadro combinado dibujado por el propietario.
ODS_DEFAULT	El elemento es el elemento predeterminado.
ODS_DISABLED	El elemento se va a dibujar como deshabilitado.
ODS_FOCUS	El elemento tiene el foco del teclado.
ODS_GRAYED	El elemento debe estar atenuado. Este bit sólo se usa en un menú.
ODS_HOTLIGHT	Se está realizando un seguimiento frecuente del elemento, es decir, el elemento se resaltará cuando el mouse esté en el elemento.
ODS_INACTIVE	El elemento está inactivo y la ventana asociada al menú está inactiva.
ODS_NOACCEL	El control se dibuja sin las indicaciones del acelerador de teclado.
ODS_NOFOCUSRECT	El control se dibuja sin indicaciones de indicador de foco.
ODS_SELECTED	El estado del elemento de menú está seleccionado.

hwndItem

Tipo: HWND

Identificador del control para cuadros combinados, cuadros de lista, botones y controles estáticos. En el caso de los menús, este miembro es un identificador del menú que contiene el elemento.

hDC

Tipo: HDC

Un identificador a un contexto de dispositivo; este contexto de dispositivo se debe usar al realizar operaciones de dibujo en el control.

rcItem

Tipo: RECT

Un rectángulo que define los límites del control que se va a dibujar. Este rectángulo se encuentra en el contexto del dispositivo especificado por el miembro hDC . El sistema recorta automáticamente todo lo que dibuja la ventana del propietario en el contexto del dispositivo para cuadros combinados, cuadros de lista y botones, pero no recorta elementos de menú. Al dibujar elementos de menú, la ventana del propietario no debe dibujar fuera de los límites del rectángulo definido por el miembro rcItem .

itemData

Tipo: ULONG_PTR

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

Si CtlType es ODT_BUTTON o ODT_STATIC, itemData es cero.

Comentarios

Algunos tipos de control, como barras de estado, no establecen el valor de CtlType.

Requisitos

Requisito	Value
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)