拡張List-Viewスタイル

これらの拡張リスト ビュー コントロール スタイルを使用するには、 LVM_SETEXTENDEDLISTVIEWSTYLE メッセージ、 またはListView_SetExtendedListViewStyle マクロまたは ListView_SetExtendedListViewStyleEx マクロのいずれかを使用します。

定数	説明
LVS_EX_AUTOAUTOARRANGE	Windows Vista 以降。 アイコンの位置が設定されていない場合は、アイコンを自動的に配置します (LVS_AUTOARRANGEに似ています)。
LVS_EX_AUTOCHECKSELECT	Windows Vista 以降。 1 回のクリックでチェックボックスを自動的に選択します。
LVS_EX_AUTOSIZECOLUMNS	Windows Vista 以降。 リストビュー列のサイズを自動的に設定します。
LVS_EX_BORDERSELECT	バージョン 4.71 以降。 項目を強調表示する代わりに、項目が選択されている場合に罫線の色を変更します。
LVS_EX_CHECKBOXES	バージョン 4.70。 リスト ビュー コントロール内のアイテムのチェック ボックスを有効にします。 このスタイルに設定すると、 コントロールは DrawFrameControl を使用して 2 つのイメージを含む状態イメージ リストを作成および設定します。 状態イメージ 1 はオフのボックスで、状態イメージ 2 はチェック ボックスです。 状態イメージを 0 に設定すると、チェック ボックスが削除されます。 バージョン 6.00 以降 チェック ボックスは、ComCtl32.dll バージョン 6 で導入されたタイル ビュー モードを除くすべてのリスト ビュー モードで表示および機能します。 タイル ビュー モードでチェックボックスをクリックすると、項目のみが選択されます。状態は変更されません。 ListView_GetCheckStateを使用して、特定のアイテムのチェック ボックスの状態を取得できます。 チェック状態を設定するには、ListView_SetCheckStateを使用します。 このスタイルが設定されている場合、ユーザーがチェック ボックスをクリックするか、スペース バーを押すと、リスト ビュー コントロールによってチェック状態が自動的に切り替わります。
LVS_EX_COLUMNOVERFLOW	ヘッダー項目の完全なセットを表示するのに十分なクライアント幅がない場合は、オーバーフロー ボタンをアイコン/タイル ビューに表示する必要があることを示します。 リスト ビュー コントロールは、オーバーフロー ボタンがクリックされたときにLVN_COLUMNOVERFLOWCLICK通知を送信します。 このフラグは、LVS_EX_HEADERINALLVIEWSも指定されている場合にのみ有効です。
LVS_EX_COLUMNSNAPPOINTS	Windows Vista 以降。 ユーザーが列のサイズを変更するときに、列の最小幅にスナップします。
LVS_EX_DOUBLEBUFFER	バージョン 6.00 以降。 ダブルバッファリングを使用してペイントし、ちらつきを軽減します。 この拡張スタイルでは、サポートされているシステムでアルファブレンドマーキーを選択することもできます。
LVS_EX_FLATSB	リスト ビューでフラット スクロール バーを有効にします。 リスト ビューのスクロール バーの外観をより詳細に制御する必要がある場合は、 フラット スクロール バー API を使用して、リスト ビューのスクロール バーを直接操作する必要があります。 システム メトリックが変更された場合は、 FlatSB_SetScrollPropを使用してスクロール バーのメトリックを調整する必要があります。 詳細については、「 フラット スクロール バー 」を参照してください。
LVS_EX_FULLROWSELECT	項目を選択すると、項目とそのすべてのサブ項目が強調表示されます。 このスタイルは、 LVS_REPORT スタイルと組み合わせてのみ使用できます。
LVS_EX_GRIDLINES	項目とサブ項目の周囲に枠線を表示します。 このスタイルは、 LVS_REPORT スタイルと組み合わせてのみ使用できます。
LVS_EX_HEADERDRAGDROP	リスト ビュー コントロール内の列のドラッグ アンド ドロップの並べ替えを有効にします。 このスタイルは、 LVS_REPORT スタイルを使用するリスト ビュー コントロールでのみ使用できます。
LVS_EX_HEADERINALLVIEWS	Windows Vista 以降。 すべてのビュー モードで列ヘッダーを表示します。
LVS_EX_HIDELABELS	バージョン 6.00 以降。 アイコンおよび小さいアイコン ビューでラベルを非表示にします。
LVS_EX_INFOTIP	リスト ビュー コントロールで LVS_EX_INFOTIP スタイルを使用すると、アイテムのヒントを表示する前に 、LVN_GETINFOTIP 通知コードが親ウィンドウに送信されます。
LVS_EX_JUSTIFYCOLUMNS	Windows Vista 以降。 アイコンは、ビュー全体を使い切る列に並んでいます。
LVS_EX_LABELTIP	リスト ビュー モードで部分的に非表示のラベルにヒント テキストがない場合、リスト ビュー コントロールはラベルを展開します。 このスタイルが設定されていない場合、リスト ビュー コントロールは、大きなアイコン モードの場合にのみ、一部非表示のラベルを展開します。
LVS_EX_MULTIWORKAREAS	リスト ビュー コントロールに LVS_AUTOARRANGE スタイルがある場合、コントロールは、1 つ以上の作業領域が定義されるまでアイコンを自動調整しません ( 「LVM_SETWORKAREAS」を参照)。 有効にするには、作業領域が定義され、項目がコントロールに追加される前に、このスタイルを設定する必要があります。
LVS_EX_ONECLICKACTIVATE	リスト ビュー コントロールは、ユーザーがアイテムをクリックしたときに 、LVN_ITEMACTIVATE 通知コードを親ウィンドウに送信します。 このスタイルでは、リスト ビュー コントロールでの ホット トラッキング も有効になります。 ホット トラッキングとは、カーソルがアイテムの上に移動すると、強調表示されているが選択されていないことを意味します。 項目のアクティブ化の詳細については、「拡張List-Viewスタイルの解説」セクションを参照してください。
LVS_EX_REGIONAL	バージョン 4.71 からバージョン 5.80 のみ。 Windows Vista 以降ではサポートされていません。 SetWindowRgn を使用して、項目アイコンとテキストのみを含むようにリスト ビュー ウィンドウ領域を設定します。 項目の一部ではない領域は、ウィンドウ領域から除外されます。 このスタイルは、 LVS_ICON スタイルを使用するリスト ビュー コントロールでのみ使用できます。
LVS_EX_SIMPLESELECT	バージョン 6.00 以降。 アイコン ビューで、コントロールの状態イメージを大きなアイコン レンダリングの右上に移動します。 アイコン ビュー以外のビューでは、変更はありません。 ユーザーがスペース バーを使用して状態を変更すると、フォーカスがある項目ではなく、選択したすべての項目が切り替わります。
LVS_EX_SINGLEROW	バージョン 6.00 以降。 使用されていません。
LVS_EX_SNAPTOGRID	バージョン 6.00 以降。 アイコン ビューでは、アイコンがグリッドに自動的にスナップされます。
LVS_EX_SUBITEMIMAGES	サブアイテムの画像を表示できます。 このスタイルは、 LVS_REPORT スタイルと組み合わせてのみ使用できます。
LVS_EX_TRACKSELECT	リスト ビュー コントロールでホット トラック選択を有効にします。 ホット トラックの選択とは、カーソルがアイテムの上に一定期間残っている場合に、アイテムが自動的に選択されることを意味します。 遅延は、 LVM_SETHOVERTIME メッセージを 含む既定のシステム設定から変更できます。 このスタイルは、リスト ビュー コントロールのすべてのスタイルに適用されます。 SystemParametersInfo を呼び出すことで、ホット トラックの選択が有効かどうかをチェックできます。
LVS_EX_TRANSPARENTBKGND	Windows Vista 以降。 背景は、 WM_PRINTCLIENTを介して親によって描画されます。
LVS_EX_TRANSPARENTSHADOWTEXT	Windows Vista 以降。 透明な背景でのみ影のテキストを有効にします。
LVS_EX_TWOCLICKACTIVATE	リスト ビュー コントロールは、ユーザーがアイテムをダブルクリックしたときに 、LVN_ITEMACTIVATE 通知コードを親ウィンドウに送信します。 このスタイルでは、リスト ビュー コントロールでの ホット トラッキング も有効になります。 ホット トラッキングとは、カーソルがアイテムの上に移動すると、強調表示されているが選択されていないことを意味します。 項目のアクティブ化の詳細については、「拡張List-Viewスタイルの解説」セクションを参照してください。
LVS_EX_UNDERLINECOLD	アクティブ化される可能性のあるホットでない項目を下線付きのテキストで表示します。 このスタイルでは、 LVS_EX_TWOCLICKACTIVATE も設定する必要があります。 項目のアクティブ化の詳細については、「拡張List-Viewスタイルの解説」セクションを参照してください。
LVS_EX_UNDERLINEHOT	アクティブ化される可能性のあるホットアイテムを下線付きのテキストで表示します。 このスタイルでは、 LVS_EX_ONECLICKACTIVATE または LVS_EX_TWOCLICKACTIVATE も設定する必要があります。 項目のアクティブ化の詳細については、「拡張List-Viewスタイルの解説」セクションを参照してください。

解説

注意

Comctl32.dllバージョン 6 は再頒布可能ではありませんが、Windows に含まれています。 バージョン 6 Comctl32.dll使用するには、マニフェストで指定します。 マニフェストの詳細については、「 ビジュアル スタイルの有効化」を参照してください。

項目の上にマウスポインターを置くと、項目が ホット になります。 ホット トラッキングが有効になっている場合、ホット アイテムは強調表示されますが、ユーザーは少なくとも 1 回アイテムをクリックして選択する必要があります。 項目をアクティブにすると、リスト ビュー コントロールはLVN_ITEMACTIVATE通知を送信します。 項目が 1 回のクリックで 選択 される状態の場合は、アイテムを選択できます。

LVS_EX_ONECLICKACTIVATE スタイルが設定されている場合は、項目を選択するために 1 回のクリックのみが必要になるため、すべてのアイテムを選択できます。 LVS_EX_TWOCLICKACTIVATEスタイルが設定されている場合、項目を選択するには 2 回のクリックが必要です。 このスタイルでは、項目を 1 回クリックした後にのみ選択できます。

LVS_EX_UNDERLINEHOTスタイルを設定すると、選択されているホットアイテムのテキストに下線が引きます。 LVS_EX_UNDERLINECOLDスタイルを設定すると、ホットではないが選択されているアイテムのテキストに下線が引きます。

必要条件

要件	値
ヘッダー	CommCtrl.h

関連項目

拡張List-Viewスタイル