建議使用 Visual Studio 2017

樹狀目錄控制項影像清單

 

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件

在樹狀目錄控制項 (CTreeCtrl) 的每個項目都可以有一組位元對應影像相關聯的。 影像在項目標籤的左邊。 影像會顯示,當項目被選取時,,和其他顯示項目時,沒有選取。 例如,項目可能會顯示一個開啟的資料夾,當選取和已關閉的資料夾時,如果沒有被選取時。

若要使用項目影像,您必須藉由建構 CImageList 物件並使用 CImageList::Create 函式建立關聯的影像清單建立影像清單。 使用 SetImageList 成員函式,然後將想要點陣圖到清單,並使清單與樹狀目錄控制項。 根據預設,所有項目顯示在影像清單中的第一個影像的選取或 nonselected 狀態。 您可以指定已選取和 nonselected 影像的索引變更特定項目的預設行為,當將項目加入至樹狀目錄控制項使用 InsertItem 成員函式。 使用 SetItemImage 成員函式,您可以在加入項目後變更索引。

樹狀目錄控制項的影像清單也可以包含覆疊影像,在項目影像會重疊。 在位元 8 到 11 的非零值樹狀控制項目狀態指定覆疊影像的以一起始的索引 (0 表示沒有覆疊影像)。 由於,以一起始的索引使用 4 位元,覆疊影像必須是在影像清單中的最後 15 個影像中。 如需樹狀控制項目狀態的詳細資訊,請參閱本主題稍早的 樹狀目錄控制項項目狀態概觀

如果狀態影像清單中指定,樹狀目錄控制項中各個項目的圖示左邊為其保留空間的狀態影像。 應用程式可以使用狀態影像,例如已選取或已清除核取方塊,表示應用程式定義的項目狀態。 在位元 12 到 15 的非零的值指定狀態影像的以一起始的索引 (0 表示沒有狀態影像)。

藉由指定而非影像索引的 I_IMAGECALLBACK 值,您可以延遲指定選取的或 nonselected 影像,直到項目會重新繪製。 I_IMAGECALLBACK 指示樹狀控制項傳送 TVN_GETDISPINFO 通知訊息查詢索引的應用程式。

GetImageList 成員函式來擷取樹狀目錄控制項的影像清單的控制代碼。 如果您需要加入多個影像加入至清單,這個函式會很有用。 如需影像清單的詳細資訊,請參閱 使用 CImageListCImageListMFC參考》中的 影像清單 和 Windows SDK。

使用 CTreeCtrl
控制項

顯示: