ListView_InsertItem マクロ (commctrl.h)

  • [アーティクル]

リスト ビュー コントロールに新しい項目を挿入します。 このマクロを使用するか、 LVM_INSERTITEM メッセージを明示的に送信できます。

構文

void ListView_InsertItem(
   hwnd,
   pitem
);

パラメーター

hwnd

型: HWND

リスト ビュー コントロールへのハンドル。

pitem

型: const LPLVITEM

リスト ビュー項目の属性を指定する LVITEM 構造体へのポインター。 iItem メンバーを使用して、新しい項目を挿入する 0 から始まるインデックスを指定します。 この値がリストビュー コントロールに現在含まれている項目の数より大きい場合、新しい項目がリストの末尾に追加され、正しいインデックスが割り当てられます。 マクロの戻り値を調べて、アイテムに割り当てられている実際のインデックスを確認します。

戻り値

なし

解説

ListView_InsertItemまたはLVM_INSERTITEMを使用してサブ項目を挿入することはできません。 LVITEM 構造体の iSubItem メンバーは 0 である必要があります。 サブ項目の設定については、 LVM_SETITEM を参照してください。

リスト ビュー コントロールにLVS_EX_CHECKBOXES スタイル セットがある場合、LVITEM 構造体の状態メンバーのビット 12 から 15 に配置された値は無視されます。 このスタイルが設定されたアイテムが追加されると、常にオフの状態に設定されます。

リスト ビュー コントロールに LVS_SORTASCENDING または LVS_SORTDESCENDING ウィンドウ スタイルがある場合、LVITEM 構造体の pszText メンバーとしてLPSTR_TEXTCALLBACK項目を挿入しようとすると、LVM_INSERTITEM メッセージは失敗します。

ListView_InsertItem マクロは、次の条件が保持されている場合、並べ替え順序の適切な位置に新しい項目を挿入します。

  • LVS_SORTXXXスタイルのいずれかを使用しています。
  • LVS_OWNERDRAW スタイルを使用していません。
  • pitem が指す構造体の pszText メンバーは、LPSTR_TEXTCALLBACKに設定されていません。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー commctrl.h