DataGrid控件的使用
数据表格控件
功能功能
用来显示数据表格内容， 双击可编辑item项目文本， 具备可框选，shift连选，ctrl跳选功能
属性介绍
- ItemHeight item高度
- Background 背景样式
- ItemStyle item样式属性
- TextStyle 文字样式属性
- HeaderBg 表头背景
- HeaderTextStyle 表头文字样式
- MultiSelect 是否支持多选
- DragSelect 是否允许拖拽选框选择
- Editable 是否允许双击编辑文字内容
控件事件介绍
1. UIG_RAD_SELECTED
| 参数名 | 事件数值 | 事件含义 | 事件参数1 | 事件参数2 |
|---|---|---|---|---|
| UIG_CONTAINER_CLICK | 0x300 | 选中item | 当前选中item index | 上一个选中itemindex，初始为-1 |
事件处理示例：
BEGIN_UIG_MESSAGE_MAP(CDemoDlg)
ON_UIG_LIST_SEL_CHANGE(_list, ItemSelected)
END_UIG_MESSAGE_MAP()
...
void CDemoDlg::ItemSelected(IUIGearsControl* control, int selectIndex, int preSelectIndex)
{
if (control == _list)
{
}
}2. UIG_LIST_MOUSEMOVE
| 参数名 | 事件数值 | 事件含义 | 事件参数1 | 事件参数2 |
|---|---|---|---|---|
| UIG_LIST_MOUSEMOVE | 0x305 | 鼠标移动到的item | 当前选中item index | - |
事件处理示例：
BEGIN_UIG_MESSAGE_MAP(CDemoDlg)
ON_UIG_LIST_MOUSE_MOVE(_list, ItemMove)
END_UIG_MESSAGE_MAP()
...
void CDemoDlg::ItemMove(IUIGearsControl* control, int moveIndex)
{
if (control == _list)
{
}
}3. UIG_LIST_ITEMDOWN
| 参数名 | 事件数值 | 事件含义 | 事件参数1 | 事件参数2 |
|---|---|---|---|---|
| UIG_LIST_ITEMDOWN | 0x304 | 鼠标点下某一item | 当前点下item index | - |
事件处理示例：
BEGIN_UIG_MESSAGE_MAP(CDemoDlg)
ON_UIG_LIST_ITEM_DOWN(_list, ItemDown)
END_UIG_MESSAGE_MAP()
...
void CDemoDlg::ItemDown(IUIGearsControl* control, int downIndex)
{
if (control == _list)
{
}
}4. UIG_LIST_DBCLICK
| 参数名 | 事件数值 | 事件含义 | 事件参数1 | 事件参数2 |
|---|---|---|---|---|
| UIG_LIST_DBCLICK | 0x303 | 鼠标双击某一item | 当前点下item index | - |
事件处理示例：
BEGIN_UIG_MESSAGE_MAP(CDemoDlg)
ON_UIG_LIST_DBCLICK(_list, ItemDBClick)
END_UIG_MESSAGE_MAP()
...
void CDemoDlg::ItemDBClick(IUIGearsControl* control, int clickIndex)
{
if (control == _list)
{
}
}接口介绍
1. AddItem
接口描述: 添加item
参数值:
参数名 参数类型 参数含义 text const tchar* item文本内容 返回值:
bool示例:
_demoCtrl->AddItem();
2. RemoveAll
接口描述: 删除所有的item
参数值:
无
返回值:
void示例:
_demoCtrl->RemoveAll();
3. RemoveAllColumns
接口描述: 删除所有的列
参数值:
无
返回值:
void示例:
_demoCtrl->RemoveAllColumns();
4. RemoveItem
接口描述: 根据索引移除item
参数值:
参数名 参数类型 参数含义 index int 索引号 返回值:
bool示例:
_demoCtrl->RemoveItem();
5. RemoveColumn
接口描述: 根据索引移除某一列
参数值:
参数名 参数类型 参数含义 index int 索引号 返回值:
bool示例:
_demoCtrl->RemoveColumn();
6. GetColumnCount
接口描述: 获取列的数量
参数值:
无
返回值:
int示例:
_demoCtrl->GetColumnCount();
7. GetColumnHeaderText
接口描述: 根据索引获取列头的文字
参数值:
参数名 参数类型 参数含义 index int 索引号 返回值:
const tchar*示例:
_demoCtrl->GetColumnHeaderText();
8. SetColumnHeaderText
接口描述: 根据索引设置列头的文字
参数值:
参数名 参数类型 参数含义 index int 索引号 text const tchar* 文字内容 返回值:
void示例:
_demoCtrl->SetColumnHeaderText();
9. GetEditable
接口描述: 获取是否可以编辑
参数值:
无
返回值:
bool示例:
_demoCtrl->GetEditable();
10. SetEditable
接口描述: 设置是否可以编辑
参数值:
参数名 参数类型 参数含义 editable bool 是否可编辑 返回值:
void示例:
_demoCtrl->SetEditable();
11. GetSelectedIndex
接口描述: 获取选中索引
参数值:
无
返回值:
int示例:
_demoCtrl->GetSelectedIndex();
12. SetSelectedIndex
接口描述: 设置选中索引，如果为-1则表示清除所有选中
参数值:
参数名 参数类型 参数含义 index int 索引号 返回值:
void示例:
_demoCtrl->SetSelectedIndex();
13. GetItemText
接口描述: 获取item文字内容
参数值:
参数名 参数类型 参数含义 row int 行索引号 col int 列索引号 返回值:
const tchar*示例:
_demoCtrl->GetItemText();
14. SetVerticalScrollBar
接口描述: 绑定垂直滚动条
参数值:
参数名 参数类型 参数含义 pScrollBar IUIGearsControl* 滚动条控件指针 返回值:
void示例:
_demoCtrl->SetVerticalScrollBar();
15. SetHorizontalScrollBar
接口描述: 绑定水平滚动条
参数值:
参数名 参数类型 参数含义 pScrollBar IUIGearsControl* 滚动条控件指针 返回值:
void示例:
_demoCtrl->SetHorizontalScrollBar();
16. SetMultiSelect
接口描述: 设置是否支持多选
参数值:
参数名 参数类型 参数含义 multiSelect bool 是否支持多选 返回值:
void示例:
_demoCtrl->SetMultiSelect();
17. GetMultiSelect
接口描述: 获取是否支持多选
参数值:
无
返回值:
bool示例:
_demoCtrl->GetMultiSelect();
18. SetDragSelect
接口描述: 设置是否打开拖拽选框选择
参数值:
参数名 参数类型 参数含义 dragSelect bool 拖拽选择 返回值:
void示例:
_demoCtrl->SetDragSelect();
19. GetDragSelect
接口描述: 获取是否打开拖拽选框选择
参数值:
无
返回值:
bool示例:
_demoCtrl->GetDragSelect();
20. IsSelected
接口描述: 是否选择某项
参数值:
参数名 参数类型 参数含义 index int 索引 返回值:
bool示例:
_demoCtrl->IsSelected();
21. GetMultiSelectedItems
接口描述: 获取多选的选择
参数值:
无
返回值:
std::vector<int> 索引列表示例:
_demoCtrl->GetMultiSelectedItems();
22. GetItemCount
接口描述: 获取item数量
参数值:
无
返回值:
int示例:
_demoCtrl->GetItemCount();
23. AppendColumn
接口描述: 插入列
参数值:
参数名 参数类型 参数含义 colName const tchar* 表头名称 colWidth int 表头宽度，默认100 返回值:
void示例:
_demoCtrl->AppendColumn();
24. SetItemText
接口描述: 设置item文字内容
参数值:
参数名 参数类型 参数含义 row int 行索引号 col int 列索引号 text const tchar* 文字内容 返回值:
bool示例:
_demoCtrl->SetItemText();
25. SetBackgroundStyle
接口描述: 设置背景样式
参数值:
参数名 参数类型 参数含义 state UICommonState 状态类型 style IUIGearsRectStyle* 样式指针 返回值:
bool示例:
_demoCtrl->SetBackgroundStyle();
26. GetBackgroundStyle
接口描述: 查询背景样式
参数值:
参数名 参数类型 参数含义 state UICommonState 状态类型 返回值:
IUIGearsRectStyle*示例:
_demoCtrl->GetBackgroundStyle();
27. SetItemStyle
接口描述: 设置Item背景样式
参数值:
参数名 参数类型 参数含义 state UICommonState 状态类型 style IUIGearsRectStyle* 样式指针 返回值:
bool示例:
_demoCtrl->SetItemStyle();
28. GetItemStyle
接口描述: 查询Item背景样式
参数值:
参数名 参数类型 参数含义 state UICommonState 状态类型 返回值:
IUIGearsRectStyle*示例:
_demoCtrl->GetItemStyle();
29. SetItemTextStyle
接口描述: 设置Item字体样式
参数值:
参数名 参数类型 参数含义 state UICommonState 状态类型 style IUIGearsTextStyle* 样式指针 返回值:
bool示例:
_demoCtrl->SetItemTextStyle();
30. GetItemTextStyle
接口描述: 查询Item字体样式
参数值:
参数名 参数类型 参数含义 state UICommonState 状态类型 返回值:
IUIGearsRectStyle*示例:
_demoCtrl->GetItemTextStyle();
31. SetHeaderBackgroundStyle
接口描述: 设置表头背景样式
参数值:
参数名 参数类型 参数含义 state UICommonState 状态类型 style IUIGearsRectStyle* 样式指针 返回值:
bool示例:
_demoCtrl->SetHeaderBackgroundStyle();
32. GetHeaderBackgroundStyle
接口描述: 获取表头背景样式
参数值:
参数名 参数类型 参数含义 state UICommonState 状态类型 style IUIGearsRectStyle* 样式指针 返回值:
bool示例:
_demoCtrl->GetHeaderBackgroundStyle();
33. SetHeaderTextStyle
接口描述: 设置表头文字样式
参数值:
参数名 参数类型 参数含义 state UIState 状态类型 style IUIGearsTextStyle* 样式指针 返回值:
bool示例:
_demoCtrl->SetHeaderTextStyle();
34. GetHeaderTextStyle
接口描述: 获取表头文字样式
参数值:
参数名 参数类型 参数含义 state UIState 状态类型 返回值:
IUIGearsTextStyle*示例:
_demoCtrl->GetHeaderTextStyle();
35. SetItemHeight
接口描述: 设置item高度
参数值:
参数名 参数类型 参数含义 height int item高度 返回值:
void示例:
_demoCtrl->SetItemHeight();
36. GetItemCount
接口描述: 获取item数量
参数值:
无
返回值:
int示例:
_demoCtrl->GetItemCount();
