CListCtrl クラス

"リスト ビュー コントロール" の機能をカプセル化します。このコントロールには項目のコレクションを表示され、各項目はイメージ リストのアイコンとラベルで構成されます。

class CListCtrl : public CWnd

メンバー

パブリック コンストラクター

名前	説明
CListCtrl::CListCtrl	CListCtrl オブジェクトを構築します。

パブリック メソッド

名前	説明
CListCtrl::ApproximateViewRect	リスト ビュー コントロールの項目を表示するために必要な幅と高さが決まります。
CListCtrl::Arrange	グリッド項目を配置します。
CListCtrl::CancelEditLabel	編集操作をキャンセルする項目のテキスト。
CListCtrl::Create	リスト コントロールを作成し、CListCtrl のオブジェクトにアタッチします。
CListCtrl::CreateDragImage	指定されたアイテムのドラッグのイメージ リストを作成します。
CListCtrl::CreateEx	指定されたウィンドウの拡張スタイルのリスト コントロールを作成し、CListCtrl のオブジェクトにアタッチします。
CListCtrl::DeleteAllItems	コントロールからすべての項目を削除します。
CListCtrl::DeleteColumn	リスト ビュー コントロールから列を削除します。
CListCtrl::DeleteItem	コントロールから項目を削除します。
CListCtrl::DrawItem	が呼び出されるとオーナー描画のコントロールの外観。
CListCtrl::EditLabel	項目のテキストの埋め込み先編集を開始します。
CListCtrl::EnableGroupView	有効にするか、またはリスト ビュー コントロールのアイテムがグループとして表示するを有効または無効にします。
CListCtrl::EnsureVisible	項目が表示されることを確認します。
CListCtrl::FindItem	特性を指定するリスト ビューの項目を検索します。
CListCtrl::GetBkColor	リスト ビュー コントロールの背景色を取得します。
CListCtrl::GetBkImage	リスト ビュー コントロールの現在の背景を取得します。
CListCtrl::GetCallbackMask	リスト ビュー コントロールのコールバックのマスクを取得します。
CListCtrl::GetCheck	項目に関連付けられた状態のイメージの現在の画面の状態を取得します。
CListCtrl::GetColumn	コントロールの列属性を取得します。
CListCtrl::GetColumnOrderArray	リスト ビュー コントロールの列の順序 (左から右) 取得します。
CListCtrl::GetColumnWidth	レポート ビューまたはリスト ビューの列の幅を取得します。
CListCtrl::GetCountPerPage	リスト ビュー コントロールに垂直に対応できる項目数を計算します。
CListCtrl::GetEditControl	項目のテキストを編集する編集コントロールのハンドルを取得します。
CListCtrl::GetEmptyText	現在のリスト ビュー コントロールが空の文字列を表示するために取得します。
CListCtrl::GetExtendedStyle	リスト ビュー コントロールの現在の拡張スタイルを取得します。
CListCtrl::GetFirstSelectedItemPosition	リスト ビュー コントロールの最初に選択されたリスト ビューの項目の位置を取得します。
CListCtrl::GetFocusedGroup	現在のリスト ビュー コントロールでキーボード フォーカスを持つグループを取得します。
CListCtrl::GetGroupCount	現在のリスト ビュー コントロールのグループの数を取得します。
CListCtrl::GetGroupInfo	リスト ビュー コントロールの特定のグループの情報を取得します。
CListCtrl::GetGroupInfoByIndex	現在のリスト ビュー コントロールの特定のグループについての情報を取得します。
CListCtrl::GetGroupMetrics	グループのメトリックを取得します。
CListCtrl::GetGroupRect	現在のリスト ビュー コントロールの特定のグループの外接する四角形を取得します。
CListCtrl::GetGroupState	現在のリスト ビュー コントロールの特定のグループの状態を取得します。
CListCtrl::GetHeaderCtrl	リスト ビュー コントロールのヘッダー コントロールを取得します。
CListCtrl::GetHotCursor	ホット トラッキングがリスト ビュー コントロールに対して有効な場合に使用するカーソルを取得します。
CListCtrl::GetHotItem	カーソルの下にリスト ビューの項目を現在取得します。
CListCtrl::GetHoverTime	リスト ビュー コントロールの現在のマウスの時刻を取得します。
CListCtrl::GetImageList	図面一覧表ビューの項目に使用するイメージ リストのハンドルを取得します。
CListCtrl::GetInsertMark	挿入マークの現在位置を取得します。
CListCtrl::GetInsertMarkColor	挿入マークの現在の色を取得します。
CListCtrl::GetInsertMarkRect	カーソルを外接する四角形を取得します。
CListCtrl::GetItem	リスト ビュー アイテムの属性を取得します。
CListCtrl::GetItemCount	リスト ビュー コントロール内の項目数を取得します。
CListCtrl::GetItemData	項目に関連付けられたアプリケーション固有の値を取得します。
CListCtrl::GetItemIndexRect	現在のリスト ビュー コントロールのサブ項目のすべてまたは一部の外接する四角形を取得します。
CListCtrl::GetItemPosition	リスト ビューの項目の位置を取得します。
CListCtrl::GetItemRect	項目の外接する四角形を取得します。
CListCtrl::GetItemSpacing	現在のリスト ビュー コントロールの項目の間隔を計算します。
CListCtrl::GetItemState	リスト ビューの項目の状態を取得します。
CListCtrl::GetItemText	リスト ビューの項目またはサブ項目のテキストを取得します。
CListCtrl::GetNextItem	指定したプロパティと特定の項目に指定された関係のリスト ビューの項目を検索します。
CListCtrl::GetNextItemIndex	指定した一連のプロパティを持つ現在のリスト ビュー コントロールに項目のインデックスを取得します。
CListCtrl::GetNextSelectedItem	リスト ビューの項目の位置インデックス、反復に次のように選択したリスト ビューの項目の位置を取得します。
CListCtrl::GetNumberOfWorkAreas	リスト ビュー コントロールの作業領域の数を取得します。
CListCtrl::GetOrigin	リスト ビュー コントロールの現在のビューの原点を取得します。
CListCtrl::GetOutlineColor	リスト ビュー コントロールの境界線の色を取得します。
CListCtrl::GetSelectedColumn	リスト コントロールで現在選択されている列のインデックスを取得します。
CListCtrl::GetSelectedCount	リスト ビュー コントロールで選択された項目の数を取得します。
CListCtrl::GetSelectionMark	リスト ビュー コントロールの選択の位置を取得します。
CListCtrl::GetStringWidth	特定の文字列を表示するために必要な最小限の列幅が決まります。
CListCtrl::GetSubItemRect	リスト ビュー コントロールのアイテムの外接する四角形を取得します。
CListCtrl::GetTextBkColor	リスト ビュー コントロール内のテキストの背景色を取得します。
CListCtrl::GetTextColor	リスト ビュー コントロールのテキストの色を取得します。
CListCtrl::GetTileInfo	リスト ビュー コントロールのタイルに関する情報を取得します。
CListCtrl::GetTileViewInfo	並べて表示ビューのリスト ビュー コントロールについての情報を取得します。
CListCtrl::GetToolTips	ツールヒントを表示するには、リスト ビュー コントロールが使用するツールヒント コントロールを取得します。
CListCtrl::GetTopIndex	最上位に表示される項目のインデックスを取得します。
CListCtrl::GetView	リスト ビュー コントロールの概要を取得します。
CListCtrl::GetViewRect	リスト ビュー コントロール内のすべての項目に外接する四角形を取得します。
CListCtrl::GetWorkAreas	リスト ビュー コントロールの現在の作業領域を取得します。
CListCtrl::HasGroup	リスト ビュー コントロールが特定のグループがあるかを判断します。
CListCtrl::HitTest	どのリスト ビューの項目が指定された位置にあるかを判断します。
CListCtrl::InsertColumn	リスト ビュー コントロールに新しい列を追加します。
CListCtrl::InsertGroup	リスト ビュー コントロールにグループを挿入します。
CListCtrl::InsertGroupSorted	グループの順序付きリストに固有のグループを挿入します。
CListCtrl::InsertItem	リスト ビュー コントロールの新しい項目を挿入します。
CListCtrl::InsertMarkHitTest	指定した点に最も近いカーソル位置を取得します。
CListCtrl::IsGroupViewEnabled	グループ ビューがリスト ビュー コントロールが有効かどうかを判定します。
CListCtrl::IsItemVisible	現在のリスト ビュー コントロール内の指定されたアイテムが表示されるかどうかを示します。
CListCtrl::MapIDToIndex	インデックスに現在のリスト ビュー コントロールのアイテムの一意の ID を割り当てます。
CListCtrl::MapIndexToID	一意の ID に現在のリスト ビュー コントロールの項目のインデックスをマップします
CListCtrl::MoveGroup	特定のグループを移動します。
CListCtrl::MoveItemToGroup	リスト ビュー コントロール内の指定されたインデックスにゼロ ベースの特定のグループを移動します。
CListCtrl::RedrawItems	リスト ビュー コントロールのアイテムのスコープを再描画するように強制します。
CListCtrl::RemoveAllGroups	リスト ビュー コントロールからすべてのグループを削除します。
CListCtrl::RemoveGroup	リスト ビュー コントロールから特定のグループを削除します。
CListCtrl::Scroll	リスト ビュー コントロールの内容をスクロールします。
CListCtrl::SetBkColor	リスト ビュー コントロールの背景色を設定します。
CListCtrl::SetBkImage	リスト ビュー コントロールの現在の背景を設定します。
CListCtrl::SetCallbackMask	リスト ビュー コントロールのコールバックのマスクを設定します。
CListCtrl::SetCheck	項目に関連付けられた状態のイメージの現在の表示状態を設定します。
CListCtrl::SetColumn	リスト ビューの列属性を設定します。
CListCtrl::SetColumnOrderArray	リスト ビュー コントロールの列の順序 (左から右) に設定します。
CListCtrl::SetColumnWidth	レポート ビューまたはリスト ビューの列の幅を変更します。
CListCtrl::SetExtendedStyle	リスト ビュー コントロールの現在の拡張スタイルを設定します。
CListCtrl::SetGroupInfo	リスト ビュー コントロールの特定のグループの情報を設定します。
CListCtrl::SetGroupMetrics	リスト ビュー コントロール グループのメトリックを設定します。
CListCtrl::SetHotCursor	ホット トラッキングがリスト ビュー コントロール用に有効にするときにカーソルを設定します。
CListCtrl::SetHotItem	リスト ビュー コントロールの現在のホット アイテムを設定します。
CListCtrl::SetHoverTime	リスト ビュー コントロールの現在のマウスの時刻を設定します。
CListCtrl::SetIconSpacing	リスト ビュー コントロール アイコンの間隔を設定します。
CListCtrl::SetImageList	リスト ビュー コントロールにイメージ リストを割り当てます。
CListCtrl::SetInfoTip	ツールヒント テキストを設定します。
CListCtrl::SetInsertMark	定義された位置にカーソルを設定します。
CListCtrl::SetInsertMarkColor	カーソル位置の色を設定します。
CListCtrl::SetItem	リスト ビューの項目の属性の一部またはすべてを設定します。
CListCtrl::SetItemCount	複数の項目を追加するには、リスト ビュー コントロールを準備します。
CListCtrl::SetItemCountEx	仮想のリスト ビュー コントロールの項目数を設定します。
CListCtrl::SetItemData	項目のアプリケーション固有の値を設定します。
CListCtrl::SetItemIndexState	現在のリスト ビュー コントロールのアイテムの状態を設定します。
CListCtrl::SetItemPosition	リスト ビュー コントロール内の指定した位置に項目を移動します。
CListCtrl::SetItemState	リスト ビュー コントロール内の項目の状態を変更します。
CListCtrl::SetItemText	リスト ビューの項目またはサブ項目のテキストを変更します。
CListCtrl::SetOutlineColor	リスト ビュー コントロールの境界線の色を設定します。
CListCtrl::SetSelectedColumn	リスト ビュー コントロールの選択された列を設定します。
CListCtrl::SetSelectionMark	リスト ビュー コントロールの選択のマークを設定します。
CListCtrl::SetTextBkColor	リスト ビュー コントロール内のテキストの背景色を設定します。
CListCtrl::SetTextColor	リスト ビュー コントロールのテキストの色を設定します。
CListCtrl::SetTileInfo	リスト ビュー コントロールのタイルの情報を設定します。
CListCtrl::SetTileViewInfo	リスト ビュー コントロールが並べて表示ビューで使用する情報を設定します。
CListCtrl::SetToolTips	リスト ビュー コントロールがツール ヒントを表示するときに使用するツール ヒント コントロールを設定します。
CListCtrl::SetView	リスト ビュー コントロールの概要を設定します。
CListCtrl::SetWorkAreas	アイコンがリスト ビュー コントロールで表示できる場所で領域を設定します。
CListCtrl::SortGroups	ユーザー定義関数のリスト ビュー コントロールのグループを並べ替えます。
CListCtrl::SortItems	並べ替えは、アプリケーション定義された比較関数を使用してビュー アイテムの一覧を示します。
CListCtrl::SortItemsEx	並べ替えは、アプリケーション定義された比較関数を使用してビュー アイテムの一覧を示します。
CListCtrl::SubItemHitTest	どのリスト ビューの項目があれば、その特定の位置によって決まります。
CListCtrl::Update	コントロールを指定された項目を再描画するように強制します。

解説

アイコンとラベルに加えて、各項目は、アイコンとラベルの右の列に表示される情報を指定できます。このコントロール (したがって CListCtrl のクラス) /98 Windows 95 および Windows NT 3.51 以降で実行されるプログラムにのみ使用できます。

次 CListCtrl は、クラスの概要です。に、概念の詳細については、を使用して CListCtrl と コントロールを参照してください。

ビュー

リスト ビュー コントロールは「ビューいう 4 種類の方法でコンテンツを」と表示できます。

• アイコン ビュー

  各項目は、大きいのラベルが付いたアイコン (32 x 32 ピクセル) としてその下に表示されます。ユーザーはリスト ビュー ウィンドウの任意の場所に項目をドラッグできます。

• 小さいアイコン ビュー

  各項目は、小さいラベルが付いたアイコン (16 x 16 ピクセル) としての右側に表示されます。ユーザーはリスト ビュー ウィンドウの任意の場所に項目をドラッグできます。

• リスト ビュー

  各項目には、の右側にラベルが付いた小さなアイコンとして表示されます。項目は、列に配置され、リスト ビュー ウィンドウの任意の場所にドラッグすることはできません。

• レポート ビュー

  各項目は右に列に配置された追加情報の行と、単独で表示されます。左端の列は小さいアイコンとラベルが含まれ、その後の列は、アプリケーションによって指定されたサブ項目が含まれます。埋め込みコントロール ヘッダー (クラス) は CHeaderCtrlこれらの列を実装します。ヘッダー コントロールの詳細およびレポート ビューの列、CListCtrl の使用: コントロール (レポートの表示) に列を追加しますを参照してください。

参照:

• サポート技術情報の文書 Q250614: " HOWTO: レポート ビュー CListCtrl 内の項目を並べ替える

• サポート技術情報の文書 Q200054: PRB: OnTimer() はリスト コントロールに対して繰り返し実行されません

コントロールの現在のリスト ビューのスタイルは現在のビューが決まります。これらのスタイルと使用の詳細については、CListCtrl の使用: リスト コントロール スタイルの変更を参照してください。

拡張スタイル

標準リストのスタイルだけでなく、CListCtrl をサポートします富ませた機能を提供する多くの拡張スタイルを並べ替える。この機能の例を以下のものが含まれています:

• マウスの選択

  有効にすると、カーソルが特定の期間の項目である場合は、項目の自動選択を許可します。

• 仮想一覧表示

  有効にすると、コントロールが DWORD まで項目をサポートするようにします。これは、アプリケーションに管理の項目データのオーバーヘッドを設定することによってできます。項目の選択、およびフォーカスの情報を除き、すべての項目の情報は、アプリケーションによって管理する必要があります。詳細については、CListCtrl の使用: 仮想のリスト コントロールを参照してください。

• 1 ~ 2 回のクリックのアクティブ化

  有効にすると、ホット トラッキング (項目のテキストの自動に強調表示) および強調表示された項目の 1 回または 2 回のクリックのアクティブ化を許可します。

• ドラッグ アンド ドロップ列の順序

  有効にすると、リスト ビュー コントロール内の列のドラッグ アンド ドロップ並べ替えることができます。レポート ビューだけで使用できます。

これらの新しい拡張スタイルの使用の詳細については、CListCtrl の使用: リスト コントロール スタイルの変更を参照してください。

項目と Subitems

リスト ビュー コントロールの各項目は、アイコン (イメージ リストから)、ラベル、現在の状態およびアプリケーション定義の値で構成されます (「データ項目」と呼ばれます)。一つ以上のサブ項目は、各項目に関連付けることができます。「」サブ項目、レポートのビューで項目のアイコンとラベルの右の列に表示される文字列です。リスト ビュー コントロール内のすべての項目は、サブ項目の数が同じである必要があります。

クラス CListCtrl はこれらの項目を挿入、削除、検索、および変更するために関数がいくつか用意されています。詳細については、CListCtrl::GetItem、CListCtrl::InsertItemと CListCtrl::FindItem、CListCtrl の使用: コントロールへの項目の追加と CListCtrl の使用: リスト コントロールにスクロールし、配置、並べ替え、検索" "を参照してください。

既定では、リスト ビュー コントロールでは、項目のアイコンおよびテキスト属性を格納する必要があります。ただし、これらの項目の種類に加え、クラス CListCtrl コールバック項目のサポート「」を参照してください。—コントロールではなく、項目」— 「コールバックは、アプリケーションでテキスト、アイコン、または両方リスト ビューの項目です。コールバックのマスクがどの項目の属性 (テキストまたはアイコン) アプリケーションによって提供されるかを指定するために使用されます。アプリケーションがコールバックの項目を使用すると、テキストやアイコンの属性をオンデマンドで指定できる必要があります。コールバックのアイテムはアプリケーションが既にこの情報の一部を保持する場合に便利です。詳細については、CListCtrl の使用: コールバックとコールバックのマスクの項目を参照してください。

イメージ リスト

リスト ビューの項目のアイコン、ヘッダー項目のイメージと適用して定義された状態は、リスト ビュー コントロールに割り当てる作成し、複数のイメージ リスト ( CImageListクラスによって実装される) 含まれています。各リスト ビュー コントロールはイメージ リストの 4 つまでの型を持つことができません:

• 大きいアイコン

  サイズのアイコンのアイコン ビューで使用します。

• 小さいアイコン

  小さいアイコン、リスト、およびアイコン ビューで使用されるアイコンの小さなバージョン用にレポート ビューに使用されます。

• アプリケーション定義の状態

  アプリケーション定義のステータスを表示する項目のアイコンの横に表示される状態イメージが含まれています。

• ヘッダー項目

  各ヘッダー コントロールの項目に表示される小さいイメージにはレポート ビューに使用されます。

既定では、リスト ビュー コントロールが破棄されるときにコントロールにイメージ リストを破棄します; ただし、開発者は、各イメージ リストの破棄は、アプリケーションによって決定されるも使用されていない場合は、この動作をカスタマイズできます。詳細については、CListCtrl の使用: リスト項目とイメージ リストを参照してください。

継承階層

CObject

CCmdTarget

CWnd

CListCtrl

必要条件

ヘッダー : afxcmn.h

参照

関連項目

CWnd クラス

階層図

CImageList クラス

概念

MFC ROWLIST サンプル