ListView_SetItemPosition マクロ (commctrl.h)

リスト ビュー コントロール内の指定した位置 (アイコンまたは小さいアイコン ビュー) に項目を移動します。 このマクロを使用することも、LVM_SETITEMPOSITION メッセージを明示的に送信することもできます。

構文

BOOL ListView_SetItemPosition(
   HWND hwndLV,
   int  i,
   int  x,
   int  y
);

パラメーター

hwndLV

型: HWND

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

i

型: int

リスト ビュー項目のインデックス。

x

型: int

ビュー座標での項目の左上隅の新しい x 位置。

y

型: int

ビュー座標での項目の左上隅の新しい y 位置。

戻り値

型: BOOL

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

備考

リスト ビュー コントロールに LVS_AUTOARRANGE スタイルがある場合、リスト ビュー コントロールは項目の位置が設定された後に配置されます。

Windows Vista では、LVS_AUTOARRANGE スタイルのリスト ビュー コントロールでこのマクロを呼び出しても何も行われないため、戻り値は FALSE。

必要条件