Compartilhar 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 um LVCOLUMN estrutura que contém os atributos da nova coluna.

  • lpszColumnHeading
    Endereço de uma seqüência de caracteres que contém o título da coluna.

  • nFormat
    Inteiro que especifica o alinhamento da coluna.Pode ser um destes valores: LVCFMT_LEFT, LVCFMT_RIGHT, or LVCFMT_CENTER.

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

  • nSubItem
    Índice de subitem associado com a coluna.Se este parâmetro for -1, nenhum subitem está associado com a coluna.

Valor de retorno

O índice da nova coluna se for bem-sucedido ou caso contrário, -1.

Comentários

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

The LVCOLUMN estrutura contém os atributos de uma coluna no modo de exibição de relatório.Também é usado para receber informações sobre uma coluna.Essa estrutura é descrita no Windows SDK.

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe CListCtrl

Gráfico de hierarquia

CListCtrl::DeleteColumn

Outros recursos

CListCtrl membros