CHeaderCtrl::InsertItem

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ヘッダーコントロールの指定インデックス位置に新しい項目を挿入します。

int InsertItem(
   int nPos,
   HDITEM* phdi 
);

パラメータ

nPos
挿入する項目の 0 から始まるインデックス。値が 0 のときは、項目はヘッダーコントロールの先頭に挿入されます。値が最大値よりも大きいときは、項目はヘッダーコントロールの末尾に追加されます。
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);
}