commctrl.h

Mensaje HDM_SETITEM

Definición

HDM_SETITEM  
wParam = (WPARAM) (int) index; 
lParam = (LPARAM) (const HD_ITEM FAR*) phdi; 

El mensaje HDM_SETITEM asigna los atributos del ítem especificado en un control de cabecera. Se puede enviar este mensaje de forma explícita o mediante el uso de la macro Header_SetItem.

Descripción

index
Índice del ítem cuyos atributos van a ser modificados.
phdi
Puntero a una estructura HDITEM. Cuando el mensaje es enviado, el miembro mask indica los atributos a asignar. Los otros miembros especifican nuevos atributos.

Valor de retorno

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

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

Observaciones

El mensaje de notificación HDN_ITEMCHANGING es enviado 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 HDM_SETITEM retorna FALSE. Si la ventana padre retorna TRUE, los cambios se llevan a cabo y la ventana padre recibe el mensaje de notificación HDN_ITEMCHANGED.