树控件(CTreeCtrl)的典型用法遵循以下模式:
创建控件。 如果在对话框模板或正在使用
CTreeView
控件,则创建对话框或视图时会自动创建。 如果要将树控件创建为其他窗口的子窗口,请使用 Create 成员函数。如果希望树控件使用图像,请通过调用 SetImageList 设置图像列表。 还可以通过调用 SetIndent 来更改缩进。 执行此作的好时机是在 OnInitDialog (对于对话框中的控件)或 OnInitialUpdate (对于视图)。
通过为每个数据项调用
CTreeCtrl
''s InsertItem 函数一次,将数据放入控件中。InsertItem
返回可用于稍后引用的项的句柄,例如添加子项时。 初始化数据的好时机是(OnInitDialog
对于对话框中的控件)或OnInitialUpdate
(对于视图)。当用户与控件交互时,它将发送各种通知消息。 可以通过在控件窗口的消息映射中添加ON_NOTIFY_REFLECT宏或将ON_NOTIFY宏添加到父窗口的消息映射,来指定要处理的每个消息的函数。 有关可能的通知列表,请参阅本主题后面的 树控件通知消息 。
调用各种 Set 成员函数来设置控件的值。 可以进行的更改包括设置缩进和更改与项关联的文本、图像或数据。
使用各种 Get 函数检查控件的内容。 还可以使用函数遍历树控件的内容,这些函数允许检索指定项的父级、子级和同级句柄。 甚至可以对特定节点的子级进行排序。
完成控件后,请确保它已正确销毁。 如果树控件位于对话框中,或者它是视图,该控件和
CTreeCtrl
对象将自动销毁。 如果没有,则需要确保控件和CTreeCtrl
对象都正确销毁。