smartclient框架组件介绍3(Menu,MenuItem,MenuButton)

Menu：菜单

菜单类(Menu)实现互动式菜单控件,并可选配图标,子菜单和快捷键,通常用于表格和树的右键菜单，和工具栏的下拉菜单。

效果图

组件属性、方法清单

Menu继承至ListGrid所以拥有ListGrid的所有方法和属性

属性	名称/描述
data: Array[menuItem]	指定菜单的菜单项
defaultWidth:Number	指定菜单项的缺省宽度
items:Array[MenuItem]	同 Menu.data
showIcons:Boolean	是否显示图标
showKeys:Boolean	是否显示快捷键
emptyMessage :String	当没有菜单项的时候需要显示的信息
cellHeight:Number	菜单项的单元高度
cellPadding:Number	菜单项外围填充宽度
target:Canvas	Optional target canvas for this menu. Available as a parameter to dynamic menuItem configuration methods such as MenuItem.checkIf().
baseStyle：String	CSS style for a normal cell
showSubmenus：Boolean	A boolean, indicating whether the submenu indicator column should be displayed. If showSubmenus is not set, the menu will show the indicator column only if one of its items specifies a submenu property. If showSubmenus is false, the submenu arrows will not be displayed, but submenus will still appear on rollover.
submenuDirection:String	Should submenus show up on our left or right. Can validly be set to "left" or "right"
iconWidth：Number	The default width applied to custom icons in this menu. This is used whenever item.iconWidth is not specified.
iconHeight：Number	The default height applied to custom icons in this menu. This is used whenever item.iconHeight is not specified.

方法	名称/描述
setData	设置在菜单中需要显示的菜单项 void setData (items：Array[MenuItems])
itemClick	当菜单被用户点击的时候该方法将为被执行 Boolean itemClick (item:Object[, colNum:Number])
showContextMenu	显示上下文菜单 Boolean showContextMenu ()
setItems	同Menu的setData方法 void setItems (items：Array[MenuItems])
hideContextMenu	隐藏上下文菜单 void hideContextMenu ()
getItem	获取指定的菜单项对象 MenuItem getItem (item:Number)
setItemProperties	设置指定菜单项的属性 void setItemProperties (item:Number, properties)
getItems	获取Menu的所有MenuItem对象 Array[MenuItem] getItems ()
getItemNum	根据MenuItems对象获取下标 Number getItemNum (item: MenuItem)
showSubmenu	显示指定菜单项的子菜单 void showSubmenu (item: MenuItem)
getSubmenu	获取指定菜单项的子菜单 Menu getSubmenu (item: MenuItem)
setItemEnabled	设置指定菜单项的使能状态 Boolean setItemEnabled (item:MenuItem[, newState:Boolean])
setItemChecked	设置指定菜单项的选中状态 Boolean setItemChecked (item: MenuItem [, newState: Boolean])
setItemTitle	设置指定菜单项的标题 Boolean setItemTitle (item:MenuItem, newTitle:String)
setItemIcon	设置指定菜单项的图标 Boolean setItemIcon (item:MenuItem, newIcon:String[, newDisabledIcon:String])

MenuItem：菜单项组件

MenuItem
类用来创建菜单项，不能实例化，需要同Menu类配合使用

效果图

组件属性、方法清单

MenuItem继承至ListGridRecord所以拥有ListGridRecord的所有方法和属性

属性	名称/描述
checked : Boolean	是否被选中
enabled : Boolean	可否可用
icon ：String	图片的url
iconHeight ：Number	图片的高度
iconWidth ：Number	图片的宽度
isSeparator ：Boolean	是否是分隔符
keys ：String	指定菜单的快捷键
submenu ：Menu	指定子菜单
title ：HTML	指定标题

方法	名称/描述
action	触发菜单的点击事件 void action ()
click	菜单的东西响应函数，当菜单被点击的时候该方法会被调用 void click (target:Canvas, item:MenuItem, menu:Menu[, colNum:Number])

click方法

详述

方法名	click
概述	当菜单被用户点击的时候，该方法就会被执行
返回	Menu对象
参数（可以是菜单组件的任意一个属性）	参数	说明
target : Canvas	菜单所在的组件
item : MenuItem	被点击的菜单项
menu : Menu	被点击菜单项所属的菜单
colNum : Number（可选）	菜单项的编号

使用示例

var menu = Menu.create({

showIcons : false,

data: [{title: "当前告警时候监控",

enabled: true,

click: function(target,item,menu ){

//do something

}

}]

});

MenuButton：菜单按钮组件

MenuButton类是Button的子类，可以弹出下拉菜单的按钮组件

效果图

组件属性、方法清单

MenuButton是Button的子类，继承Button的所有方法和属性

属性	名称/描述
height ：Number	指定按钮高度
menu ：Menu	指定按钮的弹出菜单
showMenuBelow ：Boolean	指定弹出菜单的方向，为true想下弹出，为false想上弹出
title ：String	按钮的标题