Control de encabezado

Esta sección contiene información sobre los elementos de programación usados con controles de encabezado.

Temas de introducción

Tema	Contenido
Acerca de los controles de encabezado	Un control de encabezado es una ventana que normalmente se coloca encima de las columnas de texto o números. Contiene un título para cada columna y se puede dividir en partes.
Usar controles de encabezado	En este tema se proporcionan detalles de implementación y ejemplos de código para los controles de encabezado.

Macros

Tema	Contenido
Header_ClearAllFilters	Borra todos los filtros de un control de encabezado determinado. Puede usar esta macro o enviar el mensaje HDM_CLEARFILTER explícitamente.
Header_ClearFilter	Borra el filtro de un control de encabezado determinado. Puede usar esta macro o enviar el mensaje HDM_CLEARFILTER explícitamente.
Header_CreateDragImage	Crea una versión transparente de una imagen de elemento dentro de un control de encabezado existente. Puede usar esta macro o enviar explícitamente el mensaje HDM_CREATEDRAGIMAGE .
Header_DeleteItem	Elimina un elemento de un control de encabezado. Puede usar esta macro o enviar el mensaje HDM_DELETEITEM explícitamente.
Header_EditFilter	Mueve el foco de entrada al cuadro de edición cuando un botón de filtro tiene el foco.
Header_GetBitmapMargin	Obtiene el ancho del margen (en píxeles) de un mapa de bits en un control de encabezado existente. Puede usar esta macro o enviar el mensaje HDM_GETBITMAPMARGIN explícitamente.
Header_GetFocusedItem	Obtiene el elemento de un control de encabezado que tiene el foco. Use esta macro o envíe explícitamente el mensaje HDM_GETFOCUSEDITEM .
Header_GetImageList	Obtiene el identificador de la lista de imágenes que se ha establecido para un control de encabezado existente. Puede usar esta macro o enviar el mensaje HDM_GETIMAGELIST explícitamente.
Header_GetItem	Obtiene información sobre un elemento de un control de encabezado. Puede usar esta macro o enviar el mensaje HDM_GETITEM explícitamente.
Header_GetItemCount	Obtiene un recuento de los elementos de un control de encabezado. Puede usar esta macro o enviar el mensaje HDM_GETITEMCOUNT explícitamente.
Header_GetItemDropDownRect	Obtiene las coordenadas del botón desplegable de un elemento especificado en un control de encabezado. El control de encabezado debe ser de tipo HDF_SPLITBUTTON. Use esta macro o envíe explícitamente el mensaje HDM_GETITEMDROPDOWNRECT .
Header_GetItemRect	Obtiene el rectángulo delimitador de un elemento determinado en un control de encabezado. Puede usar esta macro o enviar el mensaje HDM_GETITEMRECT explícitamente.
Header_GetOrderArray	Obtiene el orden de izquierda a derecha actual de los elementos de un control de encabezado. Puede usar esta macro o enviar el mensaje HDM_GETORDERARRAY explícitamente.
Header_GetOverflowRect	Obtiene las coordenadas del área de desbordamiento desplegable de un control de encabezado especificado. El control de encabezado debe ser de tipo HDF_SPLITBUTTON. Use esta macro o envíe explícitamente el mensaje HDM_GETOVERFLOWRECT .
Header_GetStateImageList	Obtiene el identificador de la lista de imágenes que se ha establecido para un estado de control de encabezado existente.
Header_GetUnicodeFormat	Obtiene la marca de formato de caracteres Unicode para el control. Puede usar esta macro o enviar el mensaje HDM_GETUNICODEFORMAT explícitamente.
Header_InsertItem	Inserta un nuevo elemento en un control de encabezado. Puede usar esta macro o enviar el mensaje HDM_INSERTITEM explícitamente.
Header_Layout	Recupera el tamaño y la posición correctos de un control de encabezado dentro de la ventana primaria. Puede usar esta macro o enviar el mensaje HDM_LAYOUT explícitamente.
Header_OrderToIndex	Recupera un valor de índice para un elemento en función de su orden en el control de encabezado. Puede usar esta macro o enviar el mensaje HDM_ORDERTOINDEX explícitamente.
Header_SetBitmapMargin	Establece el ancho del margen de un mapa de bits en un control de encabezado existente. Puede usar esta macro o enviar el mensaje HDM_SETBITMAPMARGIN explícitamente.
Header_SetFilterChangeTimeout	Establece el intervalo de tiempo de espera entre el momento en que se produce un cambio en los atributos de filtro y la publicación de una notificación HDN_FILTERCHANGE. Puede usar esta macro o enviar explícitamente el mensaje HDM_SETFILTERCHANGETIMEOUT .
Header_SetFocusedItem	Establece el foco en un elemento especificado en un control de encabezado. Use esta macro o envíe explícitamente el mensaje HDM_SETFOCUSEDITEM .
Header_SetHotDivider	Cambia el color de un divisor entre los elementos de encabezado para indicar el destino de una operación externa de arrastrar y colocar. Puede usar esta macro o enviar el mensaje HDM_SETHOTDIVIDER explícitamente.
Header_SetImageList	Asigna una lista de imágenes a un control de encabezado existente. Puede usar esta macro o enviar el mensaje HDM_SETIMAGELIST explícitamente.
Header_SetItem	Establece los atributos del elemento especificado en un control de encabezado. Puede usar esta macro o enviar el mensaje HDM_SETITEM explícitamente.
Header_SetOrderArray	Establece el orden de izquierda a derecha de los elementos de encabezado. Puede usar esta macro o enviar el mensaje HDM_SETORDERARRAY explícitamente.
Header_SetStateImageList	Asigna una lista de imágenes a un estado de control de encabezado existente.
Header_SetUnicodeFormat	Establece la marca de formato de caracteres UNICODE para el control. Este mensaje permite cambiar el juego de caracteres usado por el control en tiempo de ejecución en lugar de tener que volver a crear el control. Puede usar esta macro o enviar explícitamente el mensaje HDM_SETUNICODEFORMAT .

error de Hadoop

Tema	Contenido
HDM_CLEARFILTER	Borra el filtro de un control de encabezado determinado. Puede enviar este mensaje explícitamente o usar la macro Header_ClearFilter .
HDM_CREATEDRAGIMAGE	Crea una versión semitransparente de la imagen de un elemento para su uso como imagen de arrastre. Puede enviar este mensaje explícitamente o usar la macro Header_CreateDragImage .
HDM_DELETEITEM	Elimina un elemento de un control de encabezado. Puede enviar este mensaje explícitamente o usar la macro Header_DeleteItem .
HDM_EDITFILTER	Mueve el foco de entrada al cuadro de edición cuando un botón de filtro tiene el foco.
HDM_GETBITMAPMARGIN	Obtiene el ancho del margen de mapa de bits de un control de encabezado. Puede enviar este mensaje explícitamente o usar la macro Header_GetBitmapMargin .
HDM_GETFOCUSEDITEM	Obtiene el elemento de un control de encabezado que tiene el foco. Envíe este mensaje explícitamente o mediante la macro Header_GetFocusedItem . Una ventana recibe este mensaje a través de la función WindowProc.
HDM_GETIMAGELIST	Obtiene el identificador de la lista de imágenes que se ha establecido para un control de encabezado existente. Puede enviar este mensaje explícitamente o usar la macro Header_GetImageList o Header_GetStateImageList .
HDM_GETITEM	Obtiene información sobre un elemento de un control de encabezado. Puede enviar este mensaje explícitamente o usar la macro Header_GetItem .
HDM_GETITEMCOUNT	Obtiene un recuento de los elementos de un control de encabezado. Puede enviar este mensaje explícitamente o usar la macro Header_GetItemCount .
HDM_GETITEMDROPDOWNRECT	Obtiene el rectángulo delimitador del botón de división de un elemento de encabezado con estilo HDF_SPLITBUTTON. Envíe este mensaje explícitamente o mediante la macroHeader_GetItemDropDownRect.
HDM_GETITEMRECT	Obtiene el rectángulo delimitador de un elemento determinado en un control de encabezado. Puede enviar este mensaje explícitamente o usar la macro Header_GetItemRect .
HDM_GETORDERARRAY	Obtiene el orden de izquierda a derecha actual de los elementos de un control de encabezado. Puede enviar este mensaje explícitamente o usar la macro Header_GetOrderArray .
HDM_GETOVERFLOWRECT	Obtiene el rectángulo delimitador del botón de desbordamiento cuando se establece el estilo HDS_OVERFLOW en el control de encabezado y el botón de desbordamiento está visible. Envíe este mensaje explícitamente o mediante la macroHeader_GetOverflowRect.
HDM_GETUNICODEFORMAT	Obtiene la marca de formato de caracteres Unicode para el control. Puede enviar este mensaje explícitamente o usar la macro Header_GetUnicodeFormat .
HDM_HITTEST	Comprueba un punto para determinar qué elemento de encabezado, si existe, está en el punto especificado.
HDM_INSERTITEM	Inserta un nuevo elemento en un control de encabezado. Puede enviar este mensaje explícitamente o usar la macro Header_InsertItem .
HDM_LAYOUT	Recupera información utilizada para establecer el tamaño y la posición del control de encabezado dentro del rectángulo de destino de la ventana primaria. Puede enviar este mensaje explícitamente o usar la macro Header_Layout .
HDM_ORDERTOINDEX	Recupera un valor de índice para un elemento en función de su orden en el control de encabezado. Puede enviar este mensaje explícitamente o usar la macro Header_OrderToIndex .
HDM_SETBITMAPMARGIN	Establece el ancho del margen, especificado en píxeles, de un mapa de bits en un control de encabezado existente. Puede enviar este mensaje explícitamente o usar la macro Header_SetBitmapMargin .
HDM_SETFILTERCHANGETIMEOUT	Establece el intervalo de tiempo de espera entre el momento en que se produce un cambio en los atributos de filtro y la publicación de una notificación de HDN_FILTERCHANGE . Puede enviar este mensaje explícitamente o usar la macro Header_SetFilterChangeTimeout .
HDM_SETFOCUSEDITEM	Establece el foco en un elemento especificado en un control de encabezado. Envíe este mensaje explícitamente o mediante la macro Header_SetFocusedItem .
HDM_SETHOTDIVIDER	Cambia el color de un divisor entre los elementos de encabezado para indicar el destino de una operación externa de arrastrar y colocar. Puede enviar este mensaje explícitamente o usar la macro Header_SetHotDivider .
HDM_SETIMAGELIST	Asigna una lista de imágenes a un control de encabezado existente. Puede enviar este mensaje explícitamente o usar la macro Header_SetImageList o Header_SetStateImageList .
HDM_SETITEM	Establece los atributos del elemento especificado en un control de encabezado. Puede enviar este mensaje explícitamente o usar la macro Header_SetItem .
HDM_SETORDERARRAY	Establece el orden de izquierda a derecha de los elementos de encabezado. Puede enviar este mensaje explícitamente o usar la macro Header_SetOrderArray .
HDM_SETUNICODEFORMAT	Establece la marca de formato de caracteres UNICODE para el control. Este mensaje permite cambiar el juego de caracteres usado por el control en tiempo de ejecución en lugar de tener que volver a crear el control. Puede enviar este mensaje explícitamente o usar la macro Header_SetUnicodeFormat .
HDM_TRANSLATEACCELERATOR	Sin implementar.

Notificaciones

Tema	Contenido
HDN_BEGINDRAG	Enviado por un control de encabezado cuando se ha iniciado una operación de arrastre en uno de sus elementos. Este código de notificación solo se envía mediante controles de encabezado que se establecen en el estilo HDS_DRAGDROP . Este código de notificación se envía en forma de mensaje WM_NOTIFY .
HDN_BEGINFILTEREDIT	Notifica a la ventana primaria de un control de encabezado que ha comenzado una edición de filtro. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
HDN_BEGINTRACK	Notifica a la ventana primaria de un control de encabezado que el usuario ha empezado a arrastrar un divisor en el control (es decir, el usuario ha presionado el botón izquierdo del mouse mientras el cursor del mouse está en un divisor en el control de encabezado). Este código de notificación se envía en forma de mensaje WM_NOTIFY .
HDN_DIVIDERDBLCLICK	Notifica a la ventana primaria de un control de encabezado que el usuario hace doble clic en el área divisora del control. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
HDN_DROPDOWN	Enviado por un control de encabezado a su elemento primario cuando se hace clic en la flecha desplegable del control de encabezado. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
HDN_ENDDRAG	Enviado por un control de encabezado cuando una operación de arrastre ha finalizado en uno de sus elementos. Este código de notificación se envía como un mensaje WM_NOTIFY . Solo los controles de encabezado que se establecen en el estilo HDS_DRAGDROP envían esta notificación.
HDN_ENDFILTEREDIT	Notifica a la ventana primaria de un control de encabezado que ha finalizado una edición de filtro. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
HDN_ENDTRACK	Notifica a la ventana primaria de un control de encabezado que el usuario ha terminado de arrastrar un divisor. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
HDN_FILTERBTNCLICK	Notifica a la ventana primaria del control de encabezado cuando se hace clic en el botón de filtro o en respuesta a un mensaje de HDM_SETITEM .
HDN_FILTERCHANGE	Notifica a la ventana primaria del control de encabezado que los atributos de un filtro de control de encabezado se están modificando o editando.
HDN_GETDISPINFO	Se envía al propietario de un control de encabezado cuando el control necesita información sobre un elemento de encabezado de devolución de llamada. Este código de notificación se envía como un mensaje WM_NOTIFY .
HDN_ITEMCHANGED	Notifica a la ventana primaria de un control de encabezado que los atributos de un elemento de encabezado han cambiado. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
HDN_ITEMCHANGING	Notifica a la ventana primaria de un control de encabezado que los atributos de un elemento de encabezado están a punto de cambiar. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
HDN_ITEMCLICK	Notifica a la ventana primaria de un control de encabezado que el usuario ha clic en el control. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
HDN_ITEMDBLCLICK	Notifica a la ventana primaria de un control de encabezado que el usuario hace doble clic en el control. Este código de notificación se envía en forma de mensaje WM_NOTIFY . Solo los controles de encabezado que se establecen en el estilo HDS_BUTTONS envían esta notificación.
HDN_ITEMKEYDOWN	Notifica a la ventana primaria de un control de encabezado que se ha presionado una tecla con un elemento seleccionado. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
HDN_ITEMSTATEICONCLICK	Notifica a la ventana primaria de un control de encabezado que el usuario ha clic en el icono de estado de un elemento.
HDN_OVERFLOWCLICK	Enviado por un control de encabezado a su elemento primario cuando se hace clic en el botón de desbordamiento del encabezado. Este código de notificación se envía en forma de un mensaje de WM_NOTIFY .
HDN_TRACK	Notifica a la ventana primaria de un control de encabezado que el usuario arrastra un divisor en el control de encabezado. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_CUSTOMDRAW (encabezado)	Enviado por un control de encabezado para notificar a su ventana primaria sobre las operaciones de dibujo. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_RCLICK (encabezado)	Notifica a la ventana primaria de un control de vista de árbol que el usuario ha realizado clic en el botón derecho del mouse dentro del control. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_RELEASEDCAPTURE (encabezado)	Notifica a la ventana primaria de un control de encabezado que el control está liberando la captura del mouse. Este código de notificación se envía en forma de mensaje WM_NOTIFY .

Constantes

Tema	Contenido
Estilos de control de encabezado	Los controles de encabezado tienen varios estilos, descritos en esta sección, que determinan la apariencia y el comportamiento del control. Al crear el control de encabezado, se establecen los estilos iniciales.