Share via


ListView_SetColumnWidth マクロ (commctrl.h)

レポート ビューの列の幅またはリスト ビュー モードのすべての列の幅を変更するために使用されます。 このマクロを使用するか、 LVM_SETCOLUMNWIDTH メッセージを明示的に送信できます。

構文

void ListView_SetColumnWidth(
   hwnd,
   iCol,
   cx
);

パラメーター

hwnd

種類: HWND

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

iCol

型: int

有効な列の 0 から始まるインデックス。 リスト ビュー モードの場合、このパラメーターは 0 に設定する必要があります。

cx

型: int

列の新しい幅 (ピクセル単位)。 レポート ビュー モードでは、次の特別な値がサポートされています。

意味
LVSCW_AUTOSIZE
列のサイズを自動的に設定します。
LVSCW_AUTOSIZE_USEHEADER
ヘッダー テキストに合わせて列のサイズを自動的に設定します。 この値を最後の列と共に使用すると、その幅はリスト ビュー コントロールの残りの幅を埋めるように設定されます。

戻り値

なし

解説

幅が 500 ピクセルの 2 列のリスト ビュー コントロールがあるとします。 列 0 の幅が 200 ピクセルに設定されている場合は、次の呼び出しを行います。

ListView_SetColumnWidth(hwnd, 1, LVSCW_AUTOSIZE_USEHEADER)

2 番目 (および最後) の列の幅は 300 ピクセルです。

ListView_SetColumnWidthcx パラメーターを 16 ビット値に変換します。

要件

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