樹狀目錄控制項影像清單
在樹狀目錄控制項中的每個項目 (CTreeCtrl) 可以有一組與其相關聯的點陣圖影像。 在左邊的項目標籤的顯示影像。 選取的項目,且另之後若未選取此項目,則會顯示一個影像。 例如,某個項目可能會顯示開啟的資料夾,當選取時,並關閉的資料夾如果不選取這個選項。
若要使用項目影像,您必須建立影像清單,藉由建構 CImageList 物件,並使用 CImageList::Create 函式來建立影像清單連結。 然後到清單中,新增您想要的點陣圖,並將此清單與 [樹狀目錄控制項中,使用 SetImageList 成員函式。 根據預設,所有的項目會顯示選取及未選取狀態的影像清單內的第一個圖像。 您可以變更某一項目的預設行為,藉由指定的選取及未選取影像的索引時將項目加入到樹狀目錄控制項時使用 InsertItem 成員函式。 您可以變更索引之後加入項目,藉由使用 SetItemImage 成員函式。
樹狀目錄控制項的影像清單也可以包含覆疊影像,設計用來在項目影像上會重疊。 位元 8 到 11 的樹狀目錄控制項項目的狀態的非零值指定以一起始的索引覆疊影像 (0 表示無覆疊影像)。 因為使用 4 位元,以一起始的索引,則必須在前 15 張影像,在影像清單之間覆疊影像。 如需有關樹狀目錄控制項項目狀態的詳細資訊,請參閱樹狀目錄控制項項目狀態概觀稍早在本主題。
如果指定狀態影像清單,則樹狀目錄控制項就會保留狀態影像的每個項目的圖示的左側。 應用程式可以使用狀態影像,例如核取或清除核取方塊,以指出應用程式定義的項目狀態。 位元 12 至 15 的非零值指定以一起始的索引之狀態影像 (0 表示無狀態影像)。
藉由指定 I_IMAGECALLBACK 值的影像之索引,而不是您可能會延遲直到重新描繪項目,指定所選取或未選取映像。 I_IMAGECALLBACK 會指示樹狀目錄控制項來查詢索引的應用程式傳送 TVN_GETDISPINFO 通知訊息。
GetImageList 成員函式會擷取樹狀目錄控制項的影像清單的控制代碼。 這個功能很有用,如果您要將多個影像加入至清單。 相關影像清單的詳細資訊,請參閱使用 CImageList, CImageList 在 MFC 參考手冊 》,以及影像列出在Windows SDK。