Cómo agregar un elemento a un control de encabezado

En este tema se muestra cómo agregar un elemento a un control de encabezado. Normalmente, un control de encabezado tiene varios elementos de encabezado que definen las columnas del control. Puede agregar un elemento a un control de encabezado enviando el mensaje HDM_INSERTITEM al control .

Lo que necesita saber

Tecnologías

• Controles de Windows

Prerrequisitos

• C/C++
• Programación de la interfaz de usuario de Windows

Instrucciones

Use el mensaje HDM_INSERTITEM para agregar un elemento al control de encabezado. El mensaje debe incluir la dirección de una estructura HDITEM . Esta estructura define las propiedades del elemento de encabezado, que pueden incluir una cadena, una imagen con mapa de bits, un tamaño inicial y un valor de 32 bits definido por la aplicación.

En el ejemplo siguiente se muestra cómo usar el mensaje HDM_INSERTITEM y la estructura HDITEM para agregar un elemento a un control de encabezado. El nuevo elemento consta de una cadena que está justificada a la izquierda dentro del rectángulo de elemento.

// DoInsertItem - inserts an item into a header control. 
// Returns the index of the new item. 
// hwndHeader - handle to the header control. 
// iInsertAfter - index of the previous item. 
// nWidth - width of the new item. 
// lpsz - address of the item string. 
int DoInsertItem(HWND hwndHeader, int iInsertAfter, 
    int nWidth, LPTSTR lpsz) 
{ 
    HDITEM hdi; 
    int index; 
 
    hdi.mask = HDI_TEXT | HDI_FORMAT | HDI_WIDTH; 
    hdi.cxy = nWidth; 
    hdi.pszText = lpsz; 
    hdi.cchTextMax = sizeof(hdi.pszText)/sizeof(hdi.pszText[0]); 
    hdi.fmt = HDF_LEFT | HDF_STRING; 
 
    index = SendMessage(hwndHeader, HDM_INSERTITEM, 
        (WPARAM) iInsertAfter, (LPARAM) &hdi); 
 
    return index; 
}

Temas relacionados

Acerca de los controles de encabezado

Referencia de control de encabezado

Usar controles de encabezado