Compartir a través de


DRAWITEMSTRUCT (Estructura)

La estructura de DRAWITEMSTRUCT proporciona información que la ventana propietaria necesita para determinar cómo pintar un control o elemento de menú propietario- dibujado.

typedef struct tagDRAWITEMSTRUCT { 
   UINT CtlType; 
   UINT CtlID; 
   UINT itemID; 
   UINT itemAction; 
   UINT itemState; 
   HWND hwndItem; 
   HDC hDC; 
   RECT rcItem; 
   DWORD itemData; 
} DRAWITEMSTRUCT;

Parámetros

  • CtlType
    Tipo de control. Los valores de los tipos de control son:

    • Botón Propietario- dibujadoODT_BUTTON

    • Cuadro combinado Propietario- dibujadoODT_COMBOBOX

    • Cuadro de lista Propietario- dibujadoODT_LISTBOX

    • Menú Propietario- dibujadoODT_MENU

    • Control de vista de lista deODT_LISTVIEW

    • Control estático Propietario- dibujadoODT_STATIC

    • Control tab deODT_TAB

  • CtlID
    El identificador de control de un cuadro combinado, un cuadro de lista, o un botón. No utilizan este miembro para un menú.

  • itemID
    El identificador de elemento de menú de un menú o el índice del elemento en un cuadro de lista o un cuadro combinado. Para un cuadro de lista o un cuadro combinado vacío, este miembro es un valor negativo, que permite la aplicación para dibujar sólo el rectángulo de foco en las coordenadas especificadas por el miembro de rcItem aunque no hay elementos del control. El usuario puede mostrarse así si el cuadro de lista o el cuadro combinado tiene el foco de entrada. El valor de los bits del miembro de itemAction determina si el rectángulo debe ser dibujado como si el cuadro de lista o el cuadro combinado tiene foco.

  • itemAction
    Define la acción de dibujo requerido. Éste será uno o más de los bits siguientes:

    • Se establece el bit deODA_DRAWENTIRESe usa el control completo necesita debe dibujar.

    • Se establece el bit deODA_FOCUSSe usa el control obtiene o pierde el foco de entrada. El miembro de itemState debe activarse para determinar si el control tiene el foco.

    • Se establece el bit deODA_SELECTSe usa sólo cambia el estado de selección. El miembro de itemState debe activarse para determinar el nuevo estado de selección.

  • itemState
    Especifica el estado visual de elementos después de que tenga lugar la acción actual del gráfico. Es decir, si se pasa un elemento de menú a ser atenuada, marcador ODS_GRAYED de estado se establecerá. Los indicadores de estado son los siguientes:

    • Se establece el bit deODS_CHECKEDThis si el elemento de menú de activarse. Este bit sólo se utiliza en un menú.

    • Se establece el bit deODS_DISABLEDThis si el elemento se dibuja como deshabilitado.

    • Se establece el bit deODS_FOCUSThis si tiene foco.

    • Se establece el bit deODS_GRAYEDThis si el elemento se oscurecerá. Este bit sólo se utiliza en un menú.

    • Se establece el bit deODS_SELECTEDThis si está seleccionado el estado del elemento.

    • El gráfico deODS_COMBOBOXEDITThe tiene lugar en el campo de selección (control de edición) de un cuadro combinado ownerdrawn.

    • El elemento deODS_DEFAULTZ es el elemento predeterminado.

  • hwndItem
    Especifica el identificador de ventana del control para cuadros combinados, cuadros de lista, los botones y. Especifica el identificador de menú (HMENU) que contiene el elemento de los menús.

  • hDC
    Identifica un contexto de dispositivo. Este contexto de dispositivo se debe utilizar al realizar operaciones de dibujo del control.

  • rcItem
    Un rectángulo en el contexto de dispositivos especificado por el miembro de hDC que define los límites del control que se va a dibujar. Windows automáticamente recorta nada el dibujo propietario en el contexto para los cuadros combinados, cuadros de lista, botones y, pero no los elementos de menú de recorte. Al dibujar elementos de menú, el propietario no debe dibujar fuera de los límites del rectángulo definido por el miembro de rcItem .

  • itemData
    Para un cuadro combinado o un cuadro de lista, este miembro contiene el valor que se pasó al cuadro de lista con uno de los valores siguientes:

    Para obtener un menú, este miembro contiene el valor que se pasó al menú por uno de los siguientes:

Comentarios

La ventana propietaria del control o elemento de menú propietario- dibujado recibe un puntero a esta estructura como parámetro de lParam de mensajes de WM_DRAWITEM .

Requisitos

Header: winuser.h

Vea también

Referencia

CWnd::OnDrawItem

Otros recursos

Estructuras, estilos, devoluciones de llamada y mapas de mensajes