類別 CListCtrl

發行項
02/28/2013

封裝「清單檢視控制項的功能，」顯示項目的集合包含圖示 (從影像清單中) 和標籤的每個。

class CListCtrl : public CWnd

Members

公用建構函式

名稱	描述
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	擷取指定之群組的週框 (Bounding Rectangle) 目前的清單檢視控制項。
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	擷取子項目的全部或部分的週框 (Bounding Rectangle) 目前的清單檢視控制項的。
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	擷取一個項目的週框 (Bounding Rectangle) 清單檢視控制項。
CListCtrl::GetTextBkColor	擷取清單檢視控制項文字的背景色彩。
CListCtrl::GetTextColor	擷取清單檢視控制項的文字色彩。
CListCtrl::GetTileInfo	擷取關於並排顯示的資訊在清單檢視控制項。
CListCtrl::GetTileViewInfo	擷取有關清單檢視控制項的資訊在並排顯示。
CListCtrl::GetToolTips	擷取清單檢視控制項使用以顯示工具提示的工具提示控制項。
CListCtrl::GetTopIndex	擷取最頂端可見項目的索引。
CListCtrl::GetView	取得清單檢視控制項的檢視。
CListCtrl::GetViewRect	擷取所有項目的週框 (Bounding Rectangle) 清單檢視控制項。
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	強制控制項重新繪製指定的項目。

備註

除了圖示和標籤 (Label) 外，每個項目都可以在資料行中顯示的資訊在圖示和標籤右邊。這個控制項 (也 CListCtrl 類別) 給在 Windows 95 /98 和 Windows NT 3.51 版之下的程式才能使用 (含) 以後版本。

以下是 CListCtrl 類別的簡短概觀。如需深入的概念，討論，請參閱使用 CListCtrl 和控制項。

檢視

清單檢視控制項可以顯示其內容使用四種不同的方法，稱為「檢視」。

圖示。

每個項目顯示為一個大型圖示 (32 x 32 像素) 與標籤底下。使用者可以將項目加入清單檢視視窗中的任何位置。
小圖示檢視

每個項目都會顯示為小型圖示 (16 x 16 像素) 與標籤在圖示右邊。使用者可以將項目加入清單檢視視窗中的任何位置。
清單檢視

每個項目都會顯示為標籤的小圖示顯示在圖示右邊。項目在資料行中排列，無法拖曳至清單檢視視窗中的任何位置。
報告檢視

每一個項目在資料行中顯示在自己的程式碼行，而其他資訊來排列靠右對齊。最左邊的資料行包含小圖示和標籤 (Label)，然後，後續的欄包含子項目所指定的應用程式。內嵌標題控制項 (類別) CHeaderCtrl實作這些資料行。如需標題控制項和資料行的詳細資訊在 [報表檢視，請參閱使用 CListCtrl:將資料行加入至控制項 (報告檢視)。

請參閱:

知識庫文件 Q250614:HOWTO:在 CListCtrl 的排序項目在報表檢視
知識庫文件 Q200054:<PRB:OnTimer () 不會針對清單控制項重複呼叫

控制項的目前清單檢視的樣式來判斷目前的檢視。如需這些模式及其用法的詳細資訊，請參閱使用 CListCtrl:變更的清單控制項模式。

延伸樣式

除了標準清單樣式之外，將 CListCtrl 支援大量延伸樣式，提供了豐富的功能。這項功能的範例包括:

停留於選取範圍

當已啟用，讓項目的自動選取，當游標停留在某個項目的時間。
虛擬清單檢視

當已啟用，讓控制項支援 DWORD 項目。這是將額外負荷可能會處理項目資料在應用程式。除了項目選取範圍和焦點 (Focus) 資訊，必須由應用程式處理所有項目的資訊。如需詳細資訊，請參閱使用 CListCtrl:虛擬清單控制項。
一個和兩個按一下啟動。

當已啟用，讓熱追蹤 (自動反白顯示項目文字) 和反白顯示之項目的一個或兩個按一下啟動。
拖放資料行順序

啟用時，允許拖放重新排列在清單檢視控制項中的資料行。只適用於 [報表檢視。

如需使用這些新的延伸樣式的詳細資訊，請參閱使用 CListCtrl:變更的清單控制項模式。

項目和子項目

在清單檢視控制項的每個項目都包含圖示 (從影像清單)，標籤、狀態和應用程式定義的值 (稱為「項目資料」)。一個或多個子項目也與每一個項目。「子項目」，將報告檢視中，在資料行中顯示該項目的圖示和標籤右邊的字串。在清單檢視控制項中的所有項目都必須有子項目的數目。

類別 CListCtrl 外掛程式，刪除，尋找和修改這些項目提供數個函式。如需詳細資訊，請參閱 CListCtrl::GetItem、 CListCtrl::InsertItem和 CListCtrl::FindItem、使用 CListCtrl:將項目加入至控制項和使用 CListCtrl:移動，排列，排序和尋找在清單控制項。

根據預設，清單檢視控制項中項目的圖示和文字屬性管理。不過，刪除這些項目之外，類別， CListCtrl 支援回呼「項目」。回呼「項目」是應用程式的清單檢視項目 (而不是控制項—文字存放區，圖示或兩者。回呼遮罩是用來指定哪些項目屬性 (文字和圖示) 提供應用程式。如果應用程式使用回呼項目，必須能夠提供文字和圖示的屬性是在要求時。當您的應用程式已經維護一些資訊時，回呼項目很有用。如需詳細資訊，請參閱使用 CListCtrl:回呼項目和回呼遮罩。