DuiVision菜单类是CDuiMenu。有两种显示的位置,一种是在窗体顶部某个button点击后能够下拉一个菜单,还有一种是托盘图标的右键菜单。
窗体中的菜单定义方式是xml文件里设置某个button的action属性,以menu:开头。后面是菜单的XML文件名称或XML定义名,比如以下这样定义:
<imgbtn name="button.menu" pos="-110,0,-77,29" skin="IDB_BT_MENU" tip="菜单" action="menu:mainmenu.xml"/>
托盘菜单默认是依照resource.xml中定义的menu_tray指向的XML文件来载入菜单。
两种方式载入的菜单定义XML文件格式都是同样的,參考前面XML说明章节的演示样例。
菜单类的属性例如以下:
属性名 | 类型 | 说明 |
---|---|---|
width | 数字 | 菜单窗体宽度 |
item-height | 数字 | 每一个菜单项的高度 |
left | 数字 | 菜单左側图标区的宽度 |
sep-height | 数字 | 菜单分隔线的高度 |
font | 字符串 | 字体 |
fontwidth | 数字 | 字体宽度 |
frame-width | 数字 | 菜单项距离边框的宽度 |
top-height | 数字 | 菜单项顶部距离边框的高度 |
bottom-height | 数字 | 菜单项底部距离边框的高度 |
crrowhover | 颜色 | 菜单项背景颜色(鼠标移动到菜单项时候的颜色),假设不设置则使用默认颜色 |
img-rowhover | 图片 | 菜单项背景图片(鼠标移动到菜单项时候的背景图片),优先级比背景颜色高 |
img-popuparrow | 图片 | 弹出菜单箭头图片 |
经常使用函数例如以下:
函数 | 是否虚函数 | 说明 |
---|---|---|
LoadXmlFile | 否 | 载入菜单XML文件 |
AddMenu | 否 | 动态加入菜单项 |
AddSeparator | 否 | 动态加入菜单分隔线 |
SetItemTitle | 否 | 预设值菜单项的标题 |
SetItemVisible | 否 | 预设值菜单项的可见性 |
SetItemDisable | 否 | 预设值菜单项的禁用状态 |
SetItemCheck | 否 | 预设值菜单项的检查标志 |
SetMenuPoint | 否 | 刷新全部菜单项的位置信息 |
GetParentMenu | 否 | 获取父菜单对象 |
GetHoverMenuItem | 否 | 获取当前激活菜单项对象 |
菜单中载入的每一个菜单项的控件是CMenuItem类。控件类型名是menuitem,菜单项的属性例如以下:
属性名 | 类型 | 说明 |
---|---|---|
seperator | 0|1 | 是否分隔线 |
select | 0|1 | 是否选择(假设是checkbox或radiobutton类型的菜单项,此属性必须设置为1) |
check | 0|1 | 是否处于选中状态 |
group | 字符串 | 广播button所属的组名,同样组名的广播button是属于一组的。能够联动。一组中仅仅有一个会处于选中状态 |
value | 字符串 | 广播button的值,一组广播button中的多个button值是不一样的。当获取这一组广播button的值时候,获取的就是选中的button的值 |
menu | 字符串 | 引用其它的菜单的名字(通过资源定义能够找到的菜单的名字),设置了这个属性,则会将相应的菜单嵌入当前菜单中 |
image | 图片 | 菜单项左側的小图片,假设是弹出菜单,而且没有设置菜单的img-popuparrow属性。则image属性表示菜单项右側的箭头图片 |
img-count | 数字 | 设置菜单项左側图片是由几个并列的小图片组成的 |
taskmsg | 0|1 | 是否通过任务方式运行菜单处理函数,假设弹出菜单的处理函数中有堵塞或等待的操作(比如打开一个对话框),则运行过程中弹出菜单可能会由于失去焦点而将自身的对象删除,这样的情况下就须要通过任务方式运行菜单处理函数,任务方式是将操作插入任务队列。由任务队列线程再去运行菜单处理函数 |
菜单项类的经常使用函数例如以下:
函数 | 是否虚函数 | 说明 |
---|---|---|
SetCheck | 否 | 设置是否选择 |
GetCheck | 否 | 获取是否选择的状态 |
IsSeparator | 否 | 推断是否分隔线 |
SetGroupName | 否 | 设置广播button组的名字 |
GetGroupName | 否 | 获取广播button组的名字 |
GetValue | 否 | 获取广播button的值 |
GetGroupValue | 否 | 获取广播button组的值 |
ResetGroupCheck | 否 | 刷新父控件以下全部同一个组的RadioButton控件的状态 |
菜单界面示比例如以下:
DuiVision开源码下载地址(github):https://github.com/blueantst/DuiVision
蓝蚂蚁工作室主页:http://www.blueantstudio.net
DuiVision QQ群:325880743
微信公众号:blueantstudio 或搜索 蓝蚂蚁工作室