共用方式為


使用樹狀結構控件

樹狀結構控件 (CTreeCtrl) 的一般用法遵循下列模式:

  • 建立控件。 如果控件是在對話框範本中指定,或者如果您使用 CTreeView,則建立對話框或檢視時會自動建立。 如果您想要將樹狀結構控件建立為其他視窗的子視窗,請使用 Create 成員函式。

  • 如果您想要讓樹狀目錄控件使用影像,請呼叫 SetImageList 來設定影像清單。 您也可以呼叫 SetIndent 來變更縮排。 這樣做的好時機是在 OnInitDialog (適用於對話框中的控制項)或 OnInitialUpdate (針對檢視表)。

  • 針對每個數據項呼叫 CTreeCtrl's InsertItem 函式一次,將數據放入控件中。 InsertItem 會傳回您可以稍後用來參考項目的控制代碼,例如新增子項目時。 初始化數據的好時機是在 OnInitDialog (適用於對話框中的控制件) 或 OnInitialUpdate [檢視] 中。

  • 當使用者與控件互動時,它會傳送各種通知訊息。 您可以在控制視窗的訊息對應中加入ON_NOTIFY_REFLECT巨集,或者在父視窗的訊息對應中加入ON_NOTIFY巨集,以指定函數來處理您想要處理的每個訊息。 如需可能的通知清單,請參閱在本主題稍後的 樹狀控制通知訊息

  • 呼叫各種 Set 成員函式來設定控制件的值。 您可以進行的變更包括設定縮排,以及變更與專案相關聯的文字、影像或數據。

  • 使用各種 Get 函式來檢查控件的內容。 您也可以使用函式來遍歷樹狀控制項的內容,以便擷取指定專案的父節點、子節點,以及同級節點的控制代碼。 您甚至可以排序特定節點的子系。

  • 當您完成控制時,請確定它已正確銷毀。 如果樹狀目錄控件位於對話框中,或是檢視畫面,則它和 CTreeCtrl 物件會自動銷毀。 如果沒有這樣做,您必須確定該控件和 CTreeCtrl 物件都已正確終結。

另請參閱

使用 CTreeCtrl
控制項