Compartir a través de


CHeaderCtrl::InsertItem

Inserta un nuevo elemento del control de encabezado en el índice especificado.

int InsertItem( 
   int nPos, 
   HDITEM* phdi  
);

Parámetros

  • nPos
    Índice de base cero del elemento que se va a insertar. Si el valor es cero, el elemento se insertará al principio del control de encabezado. Si el valor es mayor que el valor máximo, el elemento se inserta en el final del control de encabezado.

  • phdi
    Puntero a una estructura de HDITEM que contiene información sobre el elemento que se va a insertar.

Valor devuelto

Índice del nuevo elemento si correctamente; si no – 1.

Ejemplo

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

encabezado: afxcmn.h

Vea también

Referencia

CHeaderCtrl Class

Gráfico de jerarquías

CHeaderCtrl::DeleteItem

CHeaderCtrl::GetItem