LVM_SETICONSPACING メッセージ

LVS_ICON スタイルを持つリストビュー コントロール内のアイコン間の間隔を設定します。 このメッセージは、明示的に送信することも、ListView_SetIconSpacing マクロを使用して送信することもできます。

パラメーター

wParam

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

lParam

LOWORD は、x 軸上のアイコン間に設定する距離をピクセル単位で指定します。 HIWORD は、y 軸上のアイコン間に設定する距離をピクセル単位で指定します。 「解説」を参照してください。

戻り値

下位ワードに元の x 軸距離、上位ワードに元の y 軸距離を含む DWORD 値を返します。

解説

lParam の値は、アイコン ビットマップの左上隅からの相対値です。 したがって、重複しないアイコン間の間隔を設定するには、lParam 値にアイコンのサイズとアイコン間に必要な空き間隔の量を含める必要があります。 アイコンの幅を含んでいない値は重複の原因となります。

アイコンの間隔を定義する際には、lParam 値は 4 以上に設定する必要があります。 これより小さい値では、目的のレイアウトは生成されません。 アイコンを既定の間隔にリセットするには、lParam 値を -1 に設定します。

要件

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