Partilhar via


CListCtrl::InsertColumn

Insere uma nova coluna em um controle de exibição de lista.

int InsertColumn(
   int nCol,
   const LVCOLUMN* pColumn 
);
int InsertColumn(
   int nCol,
   LPCTSTR lpszColumnHeading,
   int nFormat = LVCFMT_LEFT,
   int nWidth = -1,
   int nSubItem = -1 
);

Parâmetros

  • nCol
    O índice da nova coluna.

  • pColumn
    Endereço de uma estrutura de LVCOLUMN que contém os atributos da nova coluna.

  • lpszColumnHeading
    Endereço de uma cadeia de caracteres que contém o título de coluna.

  • nFormat
    Número inteiro que especifica o alinhamento de coluna.Pode ser um de esses valores: LVCFMT_LEFT, LVCFMT_RIGHT, ou LVCFMT_CENTER.

  • nWidth
    Largura da coluna, em pixels.Se esse parâmetro é -1, a largura da coluna não está definida.

  • nSubItem
    Índice de subitens com associado à coluna.Se esse parâmetro é -1, está associado com qualquer subitens a coluna.

Valor de retorno

O índice da nova coluna foi bem-sucedida ou -1 caso contrário.

Comentários

A coluna mais à esquerda de um controle de exibição de lista deve ser um alinhada.

A estrutura de LVCOLUMN contém os atributos de uma coluna no visualizador de relatório.Também é usada para receber informações sobre uma coluna.Essa estrutura é descrita em Windows SDK.

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe de CListCtrl

Gráfico de hierarquia

CListCtrl::DeleteColumn