构建 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 | 当选择的文件改变时触发该事件。 |
该字段的可选值包括:
该字段可选的值包括：