LVM_INSERTITEM メッセージ

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

パラメーター

wParam

ゼロを指定してください。

lParam

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

戻り値

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

解説

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

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

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

LVM_INSERTITEMメッセージは、次の条件が保持されている場合に、新しい項目を並べ替え順序で適切な位置に挿入します。

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

LVITEM 構造体にマスク メンバーにLVIF_GROUPIDが含まれていない場合、iGroupId メンバーの値は既定でI_GROUPIDCALLBACKされます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー	Commctrl.h
Unicode 名と ANSI 名	LVM_INSERTITEMW (Unicode) と LVM_INSERTITEMA (ANSI)