Freigeben über


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

Hierarchiediagramm

CHeaderCtrl::DeleteItem

CHeaderCtrl::GetItem