拡張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スタイル