Tree控件的使用
功能功能
树形控件，可展开所有item 每个item可独立设置图标
属性介绍
- ItemHeight item高度
- Background 背景样式
- ItemBg item背景样式
- TextStyle 文字样式
- ShowIcon 是否显示item图标
- IconWidth icon的宽度
- ExpandIconWidth 展开图标的宽度
- ExpandIcon 展开图标
- UnExpandIcon 收缩图标
控件事件介绍
1. UIG_TREE_SELECTED
| 参数名 | 事件数值 | 事件含义 | 事件参数1 | 事件参数2 |
|---|---|---|---|---|
| UIG_TREE_SELECTED | 0x600 | 选中节点事件 | TreeNode* 节点指针 | - |
typedef void* TreeNode;事件处理示例：
BEGIN_UIG_MESSAGE_MAP(CDemoDlg)
ON_UIG_TREE_SELECTED(_list, TreeSelected)
END_UIG_MESSAGE_MAP()
...
void CDemoDlg::TreeSelected(IUIGearsControl* control, TreeNode* node)
{
if (control == _list)
{
}
}2. UIG_TREE_DBCLICK
| 参数名 | 事件数值 | 事件含义 | 事件参数1 | 事件参数2 |
|---|---|---|---|---|
| UIG_TREE_DBCLICK | 0x602 | 双击树节点事件 | TreeNode* 节点指针 | - |
typedef void* TreeNode;事件处理示例：
BEGIN_UIG_MESSAGE_MAP(CDemoDlg)
ON_UIG_TREE_DBCLICK(_list, TreeDBClicked)
END_UIG_MESSAGE_MAP()
...
void CDemoDlg::TreeDBClicked(IUIGearsControl* control, TreeNode* node)
{
if (control == _list)
{
}
}3. UIG_TREE_RMOUSEUP
| 参数名 | 事件数值 | 事件含义 | 事件参数1 | 事件参数2 |
|---|---|---|---|---|
| UIG_TREE_DBCLICK | 0x602 | 右键树节点事件 | TreeNode* 节点指针 | - |
typedef void* TreeNode;事件处理示例：
BEGIN_UIG_MESSAGE_MAP(CDemoDlg)
ON_UIG_TREE_RMOUSEUP(_list, TreeRClicked)
END_UIG_MESSAGE_MAP()
...
void CDemoDlg::TreeRClicked(IUIGearsControl* control, TreeNode* node)
{
if (control == _list)
{
}
}接口介绍
1. RemoveAll
接口描述: 删除所有节点
参数值:
无
返回值:
void示例:
_demoCtrl->RemoveAll();
2. SetVerticalScrollBar
接口描述: 绑定垂直滚动条
参数值:
参数名 参数类型 参数含义 pScrollBar IUIGearsControl* 滚动条控件指针 返回值:
void示例:
_demoCtrl->SetVerticalScrollBar();
3. SetHorizontalScrollBar
接口描述: 绑定水平滚动条
参数值:
参数名 参数类型 参数含义 pScrollBar IUIGearsControl* 滚动条控件指针 返回值:
void示例:
_demoCtrl->SetHorizontalScrollBar();
4. SetMultiSelect
接口描述: 设置是否支持多选
参数值:
参数名 参数类型 参数含义 multiSelect bool 是否支持多选 返回值:
void示例:
_demoCtrl->SetMultiSelect();
5. InsertItem
接口描述: 插入节点
参数值:
参数名 参数类型 参数含义 parent TreeNode 父节点，如果是NULL则插入根节点下 pos int 插入位置下标 text const tchar* 文字内容 返回值:
TreeNode示例:
_demoCtrl->InsertItem();
6. AppendItem
接口描述: 在末尾插入节点
参数值:
参数名 参数类型 参数含义 parent TreeNode 父节点，如果是NULL则插入根节点下 text const tchar* 文字内容 返回值:
TreeNode示例:
_demoCtrl->AppendItem();
7. DeleteNode
接口描述: 删除节点
参数值:
参数名 参数类型 参数含义 item TreeNode 节点指针 返回值:
bool示例:
_demoCtrl->DeleteNode();
8. SetItemText
接口描述: 设置节点文本
参数值:
参数名 参数类型 参数含义 item TreeNode 节点指针 text const tchar* 节点指针 返回值:
bool示例:
_demoCtrl->SetItemText();
9. SetItemIcon
接口描述: 设置节点图标
参数值:
参数名 参数类型 参数含义 item TreeNode 节点指针 iconPath const tchar* 图标资源路径 返回值:
bool示例:
_demoCtrl->SetItemIcon();
10. SetItemIcon
接口描述: 设置节点图标
参数值:
参数名 参数类型 参数含义 item TreeNode 节点指针 iconPath const tchar* 资源名称 iconBuffer void* 二进制数据指针 length unsigned int 数据长度 返回值:
bool示例:
_demoCtrl->SetItemIcon();
11. SetItemData
接口描述: 设置用户数据指针
参数值:
参数名 参数类型 参数含义 item TreeNode 节点指针 data void* 用户数据 返回值:
bool示例:
_demoCtrl->SetItemData();
12. GetItemData
接口描述: 获取用户数据指针
参数值:
无
返回值:
void*示例:
_demoCtrl->GetItemData();
13. GetSelectedNodes
接口描述: 获取选中的节点
参数值:
无
返回值:
std::vector<TreeNode*>*示例:
_demoCtrl->GetSelectedNodes();
14. SetSelectedNode
接口描述: 设置选中的节点
参数值:
参数名 参数类型 参数含义 node TreeNode 选中节点 返回值:
bool示例:
_demoCtrl->SetSelectedNode();
15. SwapNode
接口描述: 交换两个节点
参数值:
参数名 参数类型 参数含义 node1 TreeNode 节点1 node2 TreeNode 节点2 返回值:
bool示例:
_demoCtrl->SwapNode();
16. ScrollToNode
接口描述: 滚动到某一节点
参数值:
参数名 参数类型 参数含义 node TreeNode 需要滚动到的节点 返回值:
bool示例:
_demoCtrl->ScrollToNode();
17. GetItemText
接口描述: 获取节点文本
参数值:
参数名 参数类型 参数含义 node TreeNode 节点 返回值:
const tchar*示例:
_demoCtrl->GetItemText();
18. GetParentNode
接口描述: 获取父节点
参数值:
参数名 参数类型 参数含义 node TreeNode 节点，不能为NULL 返回值:
TreeNode示例:
_demoCtrl->GetParentNode();
19. GetChildrenNodeCount
接口描述: 获取子节点的数量
参数值:
参数名 参数类型 参数含义 node TreeNode 节点 返回值:
unsigned int示例:
_demoCtrl->GetChildrenNodeCount();
20. GetChildNodeByIndex
接口描述: 通过索引获取父节点的子节点
参数值:
参数名 参数类型 参数含义 node TreeNode 父节点 index unsgined int 索引号 返回值:
TreeNode示例:
_demoCtrl->GetChildNodeByIndex();
21. SetExpandIcon
接口描述: 设置展开图标
参数值:
参数名 参数类型 参数含义 pIconPath const tchar* 图标路径 返回值:
void示例:
_demoCtrl->SetExpandIcon();
22. GetExpandIcon
接口描述: 获取展开图标
参数值:
无
返回值:
const tchar*示例:
_demoCtrl->GetExpandIcon();
23. SetUnExpandIcon
接口描述: 设置收缩图标
参数值:
参数名 参数类型 参数含义 pIconPath const tchar* 资源路径 返回值:
void示例:
_demoCtrl->SetUnExpandIcon();
24. GetUnExpandIcon
接口描述: 获取收缩图标
参数值:
无
返回值:
const tchar*示例:
_demoCtrl->GetUnExpandIcon();
25. SetItemOffset
接口描述: 设置层级之前的偏移量
参数值:
参数名 参数类型 参数含义 offset int 偏移量 返回值:
void示例:
_demoCtrl->SetItemOffset();
26. GetItemOffset
接口描述: 获取层级之前的偏移量
参数值:
无
返回值:
int示例:
_demoCtrl->GetItemOffset();
27. SetIconWidth
接口描述: 设置图标的宽度，默认是16
参数值:
参数名 参数类型 参数含义 width int 宽度值 返回值:
void示例:
_demoCtrl->SetIconWidth();
28. GetIconWidth
接口描述: 获取图标的宽度
参数值:
无
返回值:
int示例:
_demoCtrl->GetIconWidth();
29. SetExpandIconWidth
接口描述: 设置展开图标的宽度
参数值:
参数名 参数类型 参数含义 width int 宽度 返回值:
void示例:
_demoCtrl->SetExpandIconWidth();
30. GetExpandIconWidth
接口描述: 获取展开图标的宽度
参数值:
无
返回值:
int示例:
_demoCtrl->GetExpandIconWidth();
31. SetShowIcon
接口描述: 设置是否显示图标
参数值:
参数名 参数类型 参数含义 show bool 是否显示 返回值:
void示例:
_demoCtrl->SetShowIcon();
32. GetShowIcon
接口描述: 获取是否显示图标
参数值:
无
返回值:
bool示例:
_demoCtrl->GetShowIcon();
33. SetItemHeight
接口描述: 设置item高度
参数值:
参数名 参数类型 参数含义 height int item高度 返回值:
void示例:
_demoCtrl->SetItemHeight();
34. GetItemCount
接口描述: 获取item数量
参数值:
无
返回值:
int示例:
_demoCtrl->GetItemCount();
35. SetBackgroundStyle
接口描述: 设置背景样式
参数值:
参数名 参数类型 参数含义 state UICommonState 状态类型 style IUIGearsRectStyle* 样式指针 返回值:
bool示例:
_demoCtrl->SetBackgroundStyle();
36. GetBackgroundStyle
接口描述: 查询背景样式
参数值:
参数名 参数类型 参数含义 state UICommonState 状态类型 返回值:
IUIGearsRectStyle*示例:
_demoCtrl->GetBackgroundStyle();
37. SetItemStyle
接口描述: 设置Item背景样式
参数值:
参数名 参数类型 参数含义 state UICommonState 状态类型 style IUIGearsRectStyle* 样式指针 返回值:
bool示例:
_demoCtrl->SetItemStyle();
38. GetItemStyle
接口描述: 查询Item背景样式
参数值:
参数名 参数类型 参数含义 state UICommonState 状态类型 返回值:
IUIGearsRectStyle*示例:
_demoCtrl->GetItemStyle();
39. SetItemTextStyle
接口描述: 设置Item字体样式
参数值:
参数名 参数类型 参数含义 state UICommonState 状态类型 style IUIGearsTextStyle* 样式指针 返回值:
bool示例:
_demoCtrl->SetItemTextStyle();
40. GetItemTextStyle
接口描述: 查询Item字体样式
参数值:
参数名 参数类型 参数含义 state UICommonState 状态类型 返回值:
IUIGearsRectStyle*示例:
_demoCtrl->GetItemTextStyle();
