CHeaderCtrl::InsertItem

Fügt ein neues Element in ein Header-Steuerelement am angegebenen Index ein.

int InsertItem(
   int nPos,
   HDITEM* phdi 
);

Parameter

  • nPos
    Der nullbasierte Index des einzufügenden Elements.Wenn der Wert null ist, wird das Element am Anfang des Header-Steuerelements eingefügt.Wenn der Wert größer als der maximale Wert ist, wird das Element am Ende des Header-Steuerelements eingefügt.

  • phdi
    Zeiger auf eine HDITEM-Struktur, die Informationen über das einzufügende Element enthält.

Rückgabewert

Index des neuen Elements, wenn erfolgreich; andernfalls. - 1.

Beispiel

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);
}

Anforderungen

Header: afxcmn.h

Siehe auch

Referenz

CHeaderCtrl-Klasse

Hierarchien-Diagramm

CHeaderCtrl::DeleteItem

CHeaderCtrl::GetItem