ListView_SetItem マクロ (commctrl.h)

リスト ビュー アイテムの属性の一部またはすべてを設定します。 ListView_SetItem を使用して、サブ項目のテキストを設定することもできます。 このマクロを使用することも、LVM_SETITEM メッセージを明示的に送信することもできます。

構文

BOOL ListView_SetItem(
         HWND     hwnd,
   const LPLVITEM pitem
);

パラメーター

hwnd

型: HWND

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

pitem

型: const LPLVITEM

新しい項目属性を含む LVITEM 構造体へのポインター。 iItem および iSubItem メンバーは項目またはサブ項目を識別し、mask メンバーは設定する属性を指定します。 mask メンバーがLVIF_TEXT値を指定した場合、pszText メンバーは null で終わる文字列のアドレスであり、cchTextMax メンバーは無視されます。 mask メンバーがLVIF_STATE値を指定する場合、stateMask メンバーは変更する項目の状態を指定し、状態 メンバーにはそれらの状態の値が含まれます。

戻り値

型: BOOL

成功した場合 TRUE を返し、それ以外の場合は FALSE 返します。

備考

リスト ビュー項目の属性を設定するには、LVITEM 構造体の iItem メンバーを項目のインデックスに設定し、iSubItem メンバーを 0 に設定します。 項目の場合は、状態、pszText、iImage、および LVITEM 構造体の lParam メンバーを して、これらの項目パラメーターを変更できます。

サブ項目のテキストを設定するには、iItem と iSubItem メンバーを設定して特定のサブ項目を示し、pszText メンバーを使用してテキストを指定します。 または、ListView_SetItemText マクロを使用して、サブ項目のテキストを設定することもできます。 サブ項目にはこれらの属性がないため、サブ項目の 状態 または lParam メンバーを することはできません。 バージョン 4.70 以降では、サブ項目の iImage メンバーを設定できます。 リスト ビュー コントロールに LVS_EX_SUBITEMIMAGES 拡張スタイルがある場合は、サブ項目イメージが表示されます。 以前のバージョンでは、サブ項目イメージは無視されます。

必要条件