Поделиться через


CHeaderCtrl::InsertItem

Вставляет новый элемент в элемент управления заголовка по указанному индексу.

int InsertItem(
   int nPos,
   HDITEM* phdi 
);

Параметры

  • nPos
    Отсчитываемый с нуля индекс вставляемого элемента.Если значение равно нулю, элемент вставляется в начале управления заголовка.Если значение превышает максимальное значение, то элемент добавляется в конце управления заголовка.

  • phdi
    Указатель на структуру HDITEM, содержащую сведения об элементе, который необходимо вставить.

Возвращаемое значение

Индекс нового элемента, если успешно; в противном случае – 1.

Пример

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

Требования

Header: afxcmn.h

См. также

Ссылки

Класс CHeaderCtrl

Диаграмма иерархии

CHeaderCtrl::DeleteItem

CHeaderCtrl::GetItem