RadioBox控件的使用

单选控制

功能功能

单项选择器，根据Groupid进行分组控制 可通过设置产生类似标签页的效果

属性介绍

1. ShowText 是否显示文本
2. Text 文本内容
3. AlignTextToLeft 是否将文本在最左侧显示，否则在图标的右侧开始显示
4. Background 背景样式
5. TextStyle 文字样式
6. GroupId 分组id
7. ShowIcon 是否显示图标
8. SelectedIcon 选中图标
9. UnselectIcon 未选中图标
10. DisableIcon 禁用图标
11. HorAlign 图标水平位置
12. VerAlign 图标垂直位置
13. OffsetX 图标水平偏移
14. OffsetY 图标垂直偏移

控件事件介绍

1. UIG_RAD_SELECTED

事件处理示例：

 BEGIN_UIG_MESSAGE_MAP(CDemoDlg)
    ON_UIG_CONTAINER_CLICK(_container, UserClicked)
 END_UIG_MESSAGE_MAP()
 ...
 void CDemoDlg::UserClicked(IUIGearsControl* control)
{
    if (control == _container)
    {   
    }
}

接口介绍

1. IsSelected

接口描述: 是否选中

参数值:

无

返回值:

bool

示例:

_demoCtrl->IsSelected();

2. SetSelected

接口描述: 设置是否选中

参数值:

参数名	参数类型	参数含义
bSelected	bool	是否选中

返回值:

bool

示例:

_demoCtrl->SetSelected();

3. GetId

接口描述: 获取分组id

参数值:

无

返回值:

unsigned int

示例:

_demoCtrl->GetId();

4. SetId

接口描述: 设置分组id

参数值:

参数名	参数类型	参数含义
id	int	unsigned int

返回值:

unsigned int

示例:

_demoCtrl->SetId();

5. SetBackgroundStyle

接口描述: 设置背景样式

参数值:

参数名	参数类型	参数含义
state	CBK_UIState	状态枚举
style	IUIGearsRectStyle*	样式指针

返回值:

bool

参数定义:

enum CBK_UIState
{
UNCHECK_NORMAL = 0,
UNCHECK_HOT,
UNCHECK_PRESSED,
UNCHECK_DISABLE,
CHECKED_NORMAL,
CHECKED_HOT,
CHECKED_PRESSED,
CHECKED_DISABLE
};

示例:

_demoCtrl->SetBackgroundStyle();

6. GetBackgroundStyle

接口描述: 获取背景样式

参数值:

参数名	参数类型	参数含义
state	CBK_UIState	状态枚举

返回值:

IUIGearsRectStyle*

示例:

_demoCtrl->GetBackgroundStyle();

7. SetTextStyle

接口描述: 设置文字样式

参数值:

参数名	参数类型	参数含义
state	CBK_UIState	状态枚举
style	IUIGearsTextStyle*	样式指针

返回值:

bool

参数定义:

enum CBK_UIState
{
UNCHECK_NORMAL = 0,
UNCHECK_HOT,
UNCHECK_PRESSED,
UNCHECK_DISABLE,
CHECKED_NORMAL,
CHECKED_HOT,
CHECKED_PRESSED,
CHECKED_DISABLE
};

示例:

_demoCtrl->SetTextStyle();

8. GetTextStyle

接口描述: 获取文字样式

参数值:

参数名	参数类型	参数含义
state	CBK_UIState	状态枚举

返回值:

IUIGearsTextStyle*

示例:

_demoCtrl->GetTextStyle();

9. SetUnselectIcon

接口描述: 设置未选中图标路径

参数值:

参数名	参数类型	参数含义
iconPath	const tchar*	图标路径

返回值:

void

示例:

_demoCtrl->SetUnselectIcon();

10. GetUnselectIcon

接口描述: 获取未选中图标路径

参数值:

无

返回值:

const tchar*

示例:

_demoCtrl->GetUnselectIcon();

11. SetSelectedIcon

接口描述: 设置选中图标路径

参数值:

参数名	参数类型	参数含义
iconPath	const tchar*	图标路径

返回值:

void

示例:

_demoCtrl->SetSelectedIcon();

12. GetSelectedIcon

接口描述: 获取选中图标路径

参数值:

无

返回值:

const tchar*

示例:

_demoCtrl->GetSelectedIcon();

13. SetDisableIcon

接口描述: 设置禁用图标路径

参数值:

参数名	参数类型	参数含义
iconPath	const tchar*	图标路径

返回值:

void

示例:

_demoCtrl->SetDisableIcon();

14. GetDisableIcon

接口描述: 获取禁用图标路径

参数值:

无

返回值:

const tchar*

示例:

_demoCtrl->GetDisableIcon();

15. SetShowText

接口描述: 设置是否显示文本

参数值:

参数名	参数类型	参数含义
show	bool	是否显示

返回值:

void

示例:

_demoCtrl->SetShowText();

16. GetShowText

接口描述: 获取是否显示文本

参数值:

无

返回值:

bool

示例:

_demoCtrl->GetShowText();

17. SetShowIcon

接口描述: 获取是否显示图标

参数值:

参数名	参数类型	参数含义
show	bool	是否显示

返回值:

void

示例:

_demoCtrl->SetShowIcon();

18. GetShowIcon

接口描述: 获取是否显示图标

参数值:

无

返回值:

bool

示例:

_demoCtrl->GetShowIcon();

19. SetText

接口描述: 设置文本

参数值:

参数名	参数类型	参数含义
text	const tchar*	文本内容

返回值:

void

示例:

_demoCtrl->SetText();

20. GetText

接口描述: 获取文本

参数值:

无

返回值:

const tchar*

示例:

_demoCtrl->GetText();

21. SetIconHorAlign

接口描述: 设置图标水平对齐类型

参数值:

参数名	参数类型	参数含义
type	DockType	对齐类型

返回值:

void

参数定义:

enum DockType
{
UIG_DOCK_LEFTTOP = 0,
UIG_DOCK_CENTERMIDDLE,
UIG_DOCK_RIGHTBOTTOM
};

示例:

_demoCtrl->SetIconHorAlign();

22. GetIconHorAlign

接口描述: 获取图标水平对齐类型

参数值:

无

返回值:

DockType

示例:

_demoCtrl->GetIconHorAlign();

23. SetIconVerAlign

接口描述: 设置图标垂直对齐类型

参数值:

参数名	参数类型	参数含义
type	DockType	对齐类型

返回值:

void

参数定义:

enum DockType
{
UIG_DOCK_LEFTTOP = 0,
UIG_DOCK_CENTERMIDDLE,
UIG_DOCK_RIGHTBOTTOM
};

示例:

_demoCtrl->SetIconVerAlign();

24. GetIconVerAlign

接口描述: 获取图标垂直对齐类型

参数值:

无

返回值:

DockType

示例:

_demoCtrl->GetIconVerAlign();

25. SetIconOffsetX

接口描述: 设置图标水平偏移量

参数值:

参数名	参数类型	参数含义
x	int	偏移量

返回值:

void

示例:

_demoCtrl->SetIconOffsetX();

26. GetIconOffsetX

接口描述: 获取图标水平偏移量

参数值:

无

返回值:

int

示例:

_demoCtrl->GetIconOffsetX();

27. SetIconOffsetX

接口描述: 设置图标垂直偏移量

参数值:

参数名	参数类型	参数含义
x	int	偏移量

返回值:

void

示例:

_demoCtrl->SetIconOffsetX();

28. GetIconOffsetX

接口描述: 获取图标垂直偏移量

参数值:

无

返回值:

int

示例:

_demoCtrl->GetIconOffsetX();

29. SetIconOffsetX

接口描述: 设置图标是否最左侧显示

参数值:

参数名	参数类型	参数含义
alignLeft	bool	是否靠最左侧显示

返回值:

void

示例:

_demoCtrl->SetIconOffsetX();

30. GetAlignTextToLeft

接口描述: 获取图标是否最左侧显示

参数值:

无

返回值:

bool

示例:

_demoCtrl->GetAlignTextToLeft();