Header_InsertItem マクロ (commctrl.h)

ヘッダー コントロールに新しい項目を挿入します。 このマクロを使用することも、HDM_INSERTITEM メッセージを明示的に送信することもできます。

構文

int Header_InsertItem(
         HWND     hwndHD,
         int      i,
   const LPHDITEM phdi
);

パラメーター

hwndHD

型: HWND

ヘッダー コントロールへのハンドル。

i

型: int

新しい項目を挿入する項目のインデックス。 i がコントロール内の項目数以上の場合、新しい項目がヘッダー コントロールの末尾に挿入されます。 i が 0 の場合、ヘッダー コントロールの先頭に新しい項目が挿入されます。

phdi

型: const LPHDITEM

新しい項目に関する情報を含む HDITEM 構造体へのポインター。

戻り値

型: int

成功した場合は新しい項目のインデックスを返し、それ以外の場合 -1 返します。

備考

Header_InsertItem マクロは次のように定義されます。

#define Header_InsertItem(hwndHD, i, phdi) \

    (int)SendMessage((hwndHD), HDM_INSERTITEM, (WPARAM)(int)(i), \

    (LPARAM)(const LPHDITEM)(phdi))

必要条件