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

按钮的标题