次の方法で共有

ListView_InsertItem マクロ (commctrl.h)

  • [アーティクル]

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

構文

int ListView_InsertItem(
         HWND     hwnd,
   const LPLVITEM pitem
);

パラメーター

hwnd

型: HWND

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

pitem

型: const LPLVITEM

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

戻り値

型: int

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

備考

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 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー commctrl.h