Partilhar via


CHeaderCtrl::InsertItem

Insere um novo item no controle de cabeçalho no índice especificado.

int InsertItem(
   int nPos,
   HDITEM* phdi 
);

Parâmetros

  • nPos
    O índice com base zero de item a ser inserido.Se o valor for zero, o item é inserido no início do controle de cabeçalho.Se o valor é maior que o valor máximo, o item é inserido no final do controle de cabeçalho.

  • phdi
    Ponteiro a estrutura de HDITEM que contém informações sobre o item a ser inserido.

Valor de retorno

Índice do novo item se com êxito; se não – 1.

Exemplo

CString str;
HDITEM  hdi;

hdi.mask = HDI_TEXT | HDI_WIDTH | HDI_FORMAT | HDI_IMAGE;
hdi.cxy = 100; // Make all columns 100 pixels wide.
hdi.fmt = HDF_STRING | HDF_CENTER;

// Insert 6 columns in the header control.
for (int i=0; i < 6; i++)
{
   str.Format(TEXT("column %d"), i);
   hdi.pszText = str.GetBuffer(0);
   hdi.iImage = i % 3;

   m_myHeaderCtrl.InsertItem(i, &hdi);
}

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe de CHeaderCtrl

Gráfico de hierarquia

CHeaderCtrl::DeleteItem

CHeaderCtrl::GetItem