Compartilhar via

Como adicionar colunas de exibição de lista

  • Artigo

Este tópico demonstra como adicionar colunas a um controle de exibição de lista. As colunas são usadas para exibir os itens e subitens quando um controle de exibição de lista está no modo de exibição de relatório (detalhes). O texto das colunas selecionadas também pode ser exibido no modo de exibição de bloco.

O que você precisa saber

Tecnologias

Pré-requisitos

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

Instruções

Para adicionar uma coluna a um controle de exibição de lista, envie a mensagem LVM_INSERTCOLUMN ou use a macro ListView_InsertColumn. Para excluir uma coluna, use a mensagem LVM_DELETECOLUMN.

O exemplo de código C++ a seguir chama a macro ListView_InsertColumn para adicionar colunas a um controle de exibição de lista. Os títulos de coluna são definidos no arquivo de cabeçalho do aplicativo como recursos de cadeia de caracteres, que são numerados consecutivamente começando com IDS_FIRSTCOLUMN. O número de colunas é definido no arquivo de cabeçalho como C_COLUMNS.

// InitListViewColumns: Adds columns to a list-view control.
// hWndListView:        Handle to the list-view control. 
// Returns TRUE if successful, and FALSE otherwise. 
BOOL InitListViewColumns(HWND hWndListView) 
{ 
    WCHAR szText[256];     // Temporary buffer.
    LVCOLUMN lvc;
    int iCol;

    // Initialize the LVCOLUMN structure.
    // The mask specifies that the format, width, text,
    // and subitem members of the structure are valid.
    lvc.mask = LVCF_FMT | LVCF_WIDTH | LVCF_TEXT | LVCF_SUBITEM;

    // Add the columns.
    for (iCol = 0; iCol < C_COLUMNS; iCol++)
    {
        lvc.iSubItem = iCol;
        lvc.pszText = szText;
        lvc.cx = 100;               // Width of column in pixels.

        if ( iCol < 2 )
            lvc.fmt = LVCFMT_LEFT;  // Left-aligned column.
        else
            lvc.fmt = LVCFMT_RIGHT; // Right-aligned column.

        // Load the names of the column headings from the string resources.
        LoadString(g_hInst,
                   IDS_FIRSTCOLUMN + iCol,
                   szText,
                   sizeof(szText)/sizeof(szText[0]));

        // Insert the columns into the list view.
        if (ListView_InsertColumn(hWndListView, iCol, &lvc) == -1)
            return FALSE;
    }
    
    return TRUE;
}

Referência de controle List-View

Sobre controles de exibição de lista

Usando controles de exibição de lista