樹狀結構控件 (CTreeCtrl) 的一般用法遵循下列模式:
建立控件。 如果控件是在對話框範本中指定,或者如果您使用
CTreeView,則建立對話框或檢視時會自動建立。 如果您想要將樹狀結構控件建立為其他視窗的子視窗,請使用 Create 成員函式。如果您想要讓樹狀目錄控件使用影像,請呼叫 SetImageList 來設定影像清單。 您也可以呼叫 SetIndent 來變更縮排。 這樣做的好時機是在 OnInitDialog (適用於對話框中的控制項)或 OnInitialUpdate (針對檢視表)。
針對每個數據項呼叫
CTreeCtrl's InsertItem 函式一次,將數據放入控件中。InsertItem會傳回您可以稍後用來參考項目的控制代碼,例如新增子項目時。 初始化數據的好時機是在OnInitDialog(適用於對話框中的控制件) 或OnInitialUpdate[檢視] 中。當使用者與控件互動時,它會傳送各種通知訊息。 您可以在控制視窗的訊息對應中加入ON_NOTIFY_REFLECT巨集,或者在父視窗的訊息對應中加入ON_NOTIFY巨集,以指定函數來處理您想要處理的每個訊息。 如需可能的通知清單,請參閱在本主題稍後的 樹狀控制通知訊息。
呼叫各種 Set 成員函式來設定控制件的值。 您可以進行的變更包括設定縮排,以及變更與專案相關聯的文字、影像或數據。
使用各種 Get 函式來檢查控件的內容。 您也可以使用函式來遍歷樹狀控制項的內容,以便擷取指定專案的父節點、子節點,以及同級節點的控制代碼。 您甚至可以排序特定節點的子系。
當您完成控制時,請確定它已正確銷毀。 如果樹狀目錄控件位於對話框中,或是檢視畫面,則它和
CTreeCtrl物件會自動銷毀。 如果沒有這樣做,您必須確定該控件和CTreeCtrl物件都已正確終結。