Partager via


CHeaderCtrl::InsertItem

Insère un nouvel élément dans un contrôle header à l'index spécifié.

int InsertItem( 
   int nPos, 
   HDITEM* phdi  
);

Paramètres

  • nPos
    Index de base zéro de l'élément à insérer. Si la valeur est nulle, l'élément est inséré au début du contrôle header. Si la valeur est supérieure à la valeur maximale, l'élément est inséré à la fin de le contrôle header.

  • phdi
    Pointeur vers une structure de HDITEM qui contient des informations sur l'élément à insérer.

Valeur de retour

Index du nouvel élément si l'opération a réussi ; sinon – 1.

Exemple

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

Configuration requise

Header: afxcmn.h

Voir aussi

Référence

CHeaderCtrl, classe

Graphique de la hiérarchie

CHeaderCtrl::DeleteItem

CHeaderCtrl::GetItem