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