Compartilhar via

Como adicionar um item a um controle de cabeçalho

  • Artigo

Este tópico demonstra como adicionar um item a um controle de cabeçalho. Um controle de cabeçalho normalmente tem vários itens de cabeçalho que definem as colunas do controle. Você pode adicionar um item a um controle de cabeçalho enviando a mensagem HDM_INSERTITEM para o controle.

O que você precisa saber

Tecnologias

Pré-requisitos

  • C/C++
  • Programação da interface do usuário do Windows

Instruções

Use a mensagem HDM_INSERTITEM para adicionar um item ao controle de cabeçalho. A mensagem deve incluir o endereço de uma estrutura HDITEM. Essa estrutura define as propriedades do item de cabeçalho, que pode incluir uma cadeia de caracteres, uma imagem bitmap, um tamanho inicial e um valor de 32 bits definido pelo aplicativo.

O exemplo a seguir ilustra como usar a mensagem HDM_INSERTITEM e a estrutura HDITEM para adicionar um item a um controle de cabeçalho. O novo item consiste em uma cadeia de caracteres que é justificada à esquerda dentro do retângulo do item.

// 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; 
}

Sobre controles de cabeçalho

Referência de controle de cabeçalho

Usando controles de cabeçalho