共用方式為


類別 CListCtrl

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

class CListCtrl : public CWnd

Members

hfshke78.collapse_all(zh-tw,VS.110).gif公用建構函式

名稱

描述

CListCtrl::CListCtrl

建構 CListCtrl 物件。

hfshke78.collapse_all(zh-tw,VS.110).gif公用方法

名稱

描述

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::GetItemCListCtrl::InsertItemCListCtrl::FindItem使用 CListCtrl:將項目加入至控制項使用 CListCtrl:移動,排列,排序和尋找在清單控制項

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

影像清單

圖示、標題項目影像和應用程式定義狀態清單檢視項目的數個影像清單包含 (由類別實作 CImageList),您將建立和指派到清單檢視控制項。 每個清單檢視控制項可能已經有影像清單的四種不同:

  • 大型圖示

    使用在 [圖示] 檢視提供大型圖示。

  • 小圖示。

    使用以小圖示、清單和報告檢視可用來圖示檢視中圖示的較小的版本。

  • 應用程式定義狀態。

    包含狀態影像,在項目圖示旁邊顯示表示應用程式定義的狀態。

  • Header item

    使用在報表檢視會出現在每個標題控制項項目的小型影像。

根據預設,,終結時,清單檢視控制項終結影像清單中指定給它,不過,藉由終結每個影像清單的自訂這個行為,並在不使用時,由應用程式所依賴的開發人員。 如需詳細資訊,請參閱 使用 CListCtrl:清單項目和影像清單

繼承階層架構

CObject

CCmdTarget

CWnd

CListCtrl

需求

Header: afxcmn.h

請參閱

參考

CWnd 類別

階層架構圖

一個類別

概念

MFC 範例 ROWLIST