commctrl.h


Header_SetItem

La macro Header_SetItem asigna los atributos para un ítem específico de un control de cabecera. Se puede usar esta macro o enviar explícitamente un mensaje HDM_SETITEM.

Definición

BOOL Header_SetItem(
    hwndHD, 	
    index, 	
    phdi	
   );

Descripción

hwndHD
Manipulador del control de cabecera.
index
Índice del ítem cuyos atributos serán modificados.
phdi
Puntero a una estructura HDITEM. Cuando se envía el mensaje HDM_SETITEM, el miembro mask indica los atributos a asignar. Los otros miembros especifican los nuevos atributos.

Valores de retorno

Si la operación tiene éxito, el valor de retorno es TRUE.

Si la operación falla, el valor de retorno es FALSE.

Observaciones

Se envía el mensaje de notificación HDN_ITEMCHANGING a la ventana padre antes de que los atributos del ítem sean modificados. La ventana padre puede retornar FALSE para evitar los cambios, y en ese caso, Header_SetItem retorna FALSE. Si la ventana padre retorna TRUE, los cambios son realizados y la ventana padre recibe el mensaje de notificación HDN_ITEMCHANGED.

La macro Header_SetItem está definida del modo siguiente:

#define Header_SetItem(hwndHD, index, phdi) \
    (BOOL)SendMessage((hwndHD), HDM_SETITEM,  \
    (WPARAM)(int)(index), (LPARAM)(const HD_ITEM FAR*)(phdi))