关于MovieClipGrid组件

MovieClipGrid是一个可插入影片剪辑的表格,扩充了DataGrid组件的功能。因为组件都继承自影片剪辑,因此可向MovieClipGrid组件中插入组件,并可设置其属性、事件处理函数以及样式。MovieClipGrid组件中拥有两种列,一种列是和DataGrid组件中相同的一般列,另一种是可以向其中直接插入影片剪辑的影片剪辑列。影片剪辑列下各单元的影片剪辑可以为不同类型,例如可以向同一影片剪辑列中插入Button组件和Label组件。不能根据影片剪辑列进行排序,但根据一般列排序时,影片剪辑列会参与排序。影片剪辑列下的单元叫影片剪辑单元,向影片剪辑单元中插入影片剪辑时,请使用如下形式:

mcGrid.addItem({mcColumn:{id:"Button",name:"button1",label:"按钮",style:{color:"red"},click:onClick}});

这里mcGrid为一个MovieClipGrid组件的实例名,mcColumn为其中一个影片剪辑列名,onClick为一个函数。

id为必须项,指定插入的影片剪辑的联接ID名(这就要求该影片剪辑必须已经存在于该fla文件的库中),也可以为组件类名(如Button,而不是"Button",此时不要求该组件已经存在于该fla文件的库中)。name为可选项,指定插入的影片剪辑的实例名,若未指定,默认为联接ID名字小写化后加1,在组件内部使用,一般情况下没必要设置该项。style为可选项,指定插入的组件的样式,若插入的不是组件则不起任何作用,style项中的各项值务必使用字符串,否则有可能无法生效。其它项为要为该组件设置的属性和属性值,事件和事件处理函数。

上例中,在一个名为mcGrid的MovieClipGrid组件的名为mcColumn的列中,插入一个Button组件,并将其实例名设为button1,label属性设为"按钮",文字标签颜色设为红色,点击事件处理函数设为onClick()。

同样可以通过editField()方法,通过以上形式的数据修改一个影片剪辑单元中的影片剪辑。

MovieClipGrid组件继承了DataGrid组件的所有属性和样式,没有其它属性和样式。

MovieClipGrid 类

继承 UIObject > UIComponent > View > ScrollView > ScrollSelectList > List > DataGrid

 

MovieClipGrid 类的方法摘要

方法

描述

MovieClipGrid.addMovieClipColumn(name:String) 添加一个影片剪辑列
MovieClipGrid.addMovieClipColumnAt(index:Number,name:String) 在指定索引处添加一个影片剪辑列
MovieClipGrid.isMovieClipCell(index:Number,columnName:String):Boolean 判断指定单元是否影片剪辑单元
MovieClipGrid.isMovieClipColumn(columnName:String):Boolean 判断指定列是否影片剪辑列
MovieClipGrid.addCellEventHandler(index:Number,columnName:String,eventName:String,handler:Function) 为指定单元的影片剪辑添加事件处理函数
MovieClipGrid.getCellEventHandler(index:Number,columnName:String,eventName:String):Function 获取指定单元的影片剪辑的事件处理函数
MovieClipGrid.removeCellEventHandler(index:Number,columnName:String,eventName:String) 删除指定单元的影片剪辑的指定事件处理函数
MovieClipGrid.setCellProperty(index:Number,columnName:String,propertyName:String,value) 为指定单元的影片剪辑设置属性值
MovieClipGrid.setCellProperties(index:Number,columnName:String,data:Object) 同时为指定单元的影片剪辑设置多个属性值
MovieClipGrid.getCellProperty(index:Number,columnName:String,propertyName:String) 获取指定单元的影片剪辑的指定属性的值
MovieClipGrid.setCellStyle(index:Number,columnName:String,styleName:String,value) 设置指定单元的组件的指定样式
MovieClipGrid.setCellStyles(index:Number,columnName:String,style) 设置指定单元的组件的多个样式
MovieClipGrid.setCellStyleFromCSS(index:Number,columnName:String,url:String,section:String) 设置指定单元的组件的样式为CSS文件中的样式
MovieClipGrid.getCellStyle(index:Number,columnName:String,styleName:String) 获取指定单元的组件的指定样式的值
MovieClipGrid.setColumnStyle(columnName:String,styleName:String,value) 设置指定列中所有组件的指定样式
MovieClipGrid.setColumnStyles(columnName:String,style) 设置指定列中所有组件的多个样式
MovieClipGrid.setColumnStyleFromCSS(columnName:String,url:String,section:String) 设置指定列中所有组件的样式为CSS文件中的样式

继承 DataGrid 类中的所有方法。

MovieClipGrid 类的事件摘要

事件

描述

MovieClipGrid.init

初始化即组件第一次显示时广播,可用于初始化组件中的某些数据。

继承 DataGrid 类中的所有事件。