构建 UploadControl 类的新实例。
全称 | mx.controls.UploadControl |
命名空间 | mx.controls |
类 | UploadControl |
继承层次结构 | UploadControlControl |
源文件 | ~\mx\scripts\controls\UploadControl.js |
JavaScript 代码 |
var upload = new mx.controls.UploadControl(
{
filePath : "D:\\testUpload\\inner\\",
height : 200,
baseUrl : mx.mappath("~/../mx/servlets/fileUpload")
}); |
名称 | 说明 |
UploadControl() | 构建 UploadControl 类的新实例。 |
名称 | 说明 |
init() |
名称 | 说明 |
alias | 获取或设置一个字符串,表示控件的别名。 |
allowTypes | 设置或获取一个字符串,表示允许上传的文件类型,多个扩展名用逗号隔开。值为 null 时表示允许上传所有文件。 |
baseUrl | 获取或设置一个字符串,表示后台服务所在路径。MX 框架提供两个服务路径可供选择。 mx.mappath("~/../mx/servlets/fileUpload") 供管理指定目录下的文件时使用, mx.mappath("~/../mx/servlets/dataFileUpload") 供管理表单、表格对应的数据附件时使用。 用户可以根据需要使用自己的服务路径。 |
border | 获取控件的边框样式。如“1px solid red”,表示边框的样式为 1 像素红色的实线。请使用 setBorder 方法设置该字段的值。 |
bottom | 获取控件的下边界与父容器下边界的像素距离。请使用 setBottom 方法设置该字段的值。 |
colName | 设置或获取一个字符串,表示上传控件在存储表单数据的表中对应的列名。 当控件类型为 form 时,此属性有值。 |
cssClass | 指定css伪类名称,设置控件显示样式 |
display | 获取控件的显示样式值。如“none”,表示隐藏控件; “block”表示强制作为块对象呈递。请使用 setDisplay。注:该"block"值不能在ComplexGrid控件中使用。 方法设置该字段的值。 |
enabled | 获取控件是否可以对用户交互作出响应。如果该值为 true,则表示控件可以对用户交互作出响应;反之则不能。 请使用 setEnabled 方法设置该字段的值。 |
eTag | 获取控件的标签。 |
fileNames | 获取一个字符串,表示当前已经上传的文件名,多个文件名用分号分隔。 |
filePath | 获取或设置一个字符串,表示上传文件在服务器上的保存路径。 |
filesLimit | 设置或获取一个数字,表示允许上传的文件个数。为 0 时表示没有限制。 |
isVirtual | 指示列是否虚拟,如果列是虚拟的话,将不会执行业务表的逻辑 |
layoutConfigs | 获取或者设置一个 JSON 对象,该属性表示控件在父容器中的布局配置参数。该属性只有在控件父容器运用布局器才会生效。 |
left | 获取控件的左边界与父容器左边界的像素距离。请使用 setLeft 方法设置该字段的值。 |
limitTypes | 设置或获取一个字符串,表示禁止上传的文件类型,多个扩展名用逗号隔开。需要先满足 UploadControl.allowTypes。 |
maxSize | 获取或设置一个数字,表示上传文件的大小所允许的最大值,单位 “KB”。如果为“-1”表示无限制。 |
padding | 获取控件的内边距。如“4px”表示上下左右的内边距均为 4 像素; “4px 2px 3px 1px”则表示上边距为 4 像素,右边距为 2 像素,下边距为 3 像素,左边距为 1 像素。请使用 setPadding 方法设置该字段的值。 |
parent | 获取控件所属的父对象。 |
permissionID | 获取或设置一个字符串,表示控件的权限标识。 |
pkVal | 设置或获取一个字符串,表示上传控件所属数据的主键值。 当控件类型为 form 时,此属性有意义;若此时此属性没有值,控件不会响应点击事件。 |
position | 获取控件位置样式值。如“static”,表示无特殊定位,对象遵循 HTML 定位规则。请使用 setPosition
方法设置该字段的值。
该字段的可选值包括:
|
primaryKey | 设置或获取一个字符串,表示上传控件所属数据表的主键列名。 当控件类型为 form 时,此属性有值。 |
right | 获取控件的右边界与父容器右边界的像素距离。请使用 setRight 方法设置该字段的值。 |
tableName | 设置或获取一个字符串,表示上传控件所属数据的表名。 当控件类型为 form 时,此属性有值。 |
top | 获取控件的上边界与父容器上边界的像素距离。请使用 setTop 方法设置该字段的值。 |
type | 设置或获取一个字符串,表示当前上传控件的类型。 当类型为 path 时,表示管理指定目录下的文件; 当类型为 form 时,表示管理表单对应的数据的附件。 |
uploadMode | 设置或获取一个字符串,表示保存文件的方式。 当控件类型为 form 时,此属性有意义。
该字段可选的值包括:
|
vault | 获取一个对象,表示上传组件对应的工具类。 |
visible | 获取一个 Boolean 值,表示控件是否可见。如果该值为 true,则表示控件可见;反之则不可见。请使用 setVisible 方法设置该字段的值。 |
width | 获取控件的宽度。可以是数字(如 500)、字符串(如“500px”或“50%”)。请使用 setWidth 方法设置该字段的值。 |
$e | 获取该控件的占位符,该占位符为一个 JQuery 对象。 |
名称 | 说明 |
onallitemuploaded | 所有文件上传成功后触发该事件 |
onclosed | 当控件点击关闭按钮时,将触发该事件。 |
onitemuploaded | 上传项上传之后触发该事件。 |
onitemuploading | 上传项上传之前触发该事件。 |
onselectionchanged | 当选择的文件改变时触发该事件。 |
该字段的可选值包括:
该字段可选的值包括: