全称 mx.controls.Control
命名空间 mx.controls
类 Control
继承层次结构 Control
源文件 ~\mx\scripts\controls\Control.js
抽象类。表示 MX 框架中所有控件的基类，它继承于 {@link MXComponent} 类。框架中控件包含有基础控件、容器控件、编辑器控件、数据控件等。

构造函数

名称 说明
Control() 构建 Control 类的新实例。

初始化函数

名称 说明
init()

方法

名称 说明
contains($p_target) 返回一个 Boolean 值，该值表示控件的容器中是否包含该 JQuery 对象。
dispose() 释放对象运行时动态生成的内容（属性、方法、事件）。
getContext() 获取控件当前所属 Weblet 的上下文信息（ WebletContext 类型）。
getEl() 获取控件容器对应的 HTML DOM 元素对象。
hide() 隐藏控件，设置控件不可见。
moveTo(p_left, p_top) 移动控件到指定位置。@param p_left 一个数字，表示 css 样式的 left 属性。 @param p_top 一个数字，表示 css 样式的 top 属性。
resizeTo(p_width, p_height) 重设控件的大小。@param p_width 控件的宽度，可以是数字（如 100），也可以是字符串（如 “100%”）。 @param p_height 控件的高度，可以是数字（如 100），也可以是字符串（如 “100%”）。
setBorder(p_border) 设置控件的边框样式。@param p_border 一个字符串，表示css样式的 border 属性。
setBottom(p_bottom) 设置 bottom 字段的值。@param p_bottom 控件的下边界与父容器下边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。
setCss(p_css) 设置 css 字段的值。 @param p_css 一个 JSON 对象，表示控件的 CSS 样式。
setCssClass(p_cssClass) 设置 cssClass 字段的值 @param p_cssClass 一个String 对象，样式classname
setDisplay(p_display) 设置 display 字段的值。@param p_display css 样式的 display 属性。
setEnabled(p_enabled) 设置 enabled 字段的值。
setHeight(p_height) 设置 height 字段的值。 注：子类UploadControl上传控件不支持百分比设置高度 @param p_height 控件的高度，可以是数字（如 100），也可以是字符串（如 “100%”）。
setLeft(p_left) 设置 left 字段的值。 @param p_left 控件的左边界与父容器左边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。
setPadding(p_padding) 设置控件的内边距。@param p_padding 一个字符串，表示css样式的 padding 属性。
setPosition(p_position) 设置 position 字段的值。@param p_position 一个字符串，表示 css 样式的 position 属性。
setRight(p_right) 设置 right 字段的值。@param p_right 控件的右边界与父容器右边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。
setTop(p_top) 设置 top 字段的值。 @param p_top 控件的上边界与父容器上边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。
setVisible(p_visible) 设置 visible 字段的值。@param p_visible 一个 Boolean 值，表示控件是否可见。
setWidth(p_width) 设置 width 字段的值。@param p_width 控件的高度,可以是数字（如 500）、字符串（如“500px”或“50%”）.
show() 显示控件，设置控件可见。
$(p_expression) 该方法与 me.$e.find(p_expression) 等同。
$wrap([p_obj]) 返回一个 JQuery 对象。

字段

名称 说明
alias 获取或设置一个字符串，表示控件的别名。
border 获取控件的边框样式。如“1px solid red”，表示边框的样式为 1 像素红色的实线。请使用 setBorder 方法设置该字段的值。
bottom 获取控件的下边界与父容器下边界的像素距离。请使用 setBottom 方法设置该字段的值。
cssClass 指定css伪类名称，设置控件显示样式
display 获取控件的显示样式值。如“none”，表示隐藏控件； “block”表示强制作为块对象呈递。请使用 setDisplay方法设置该字段的值。
enableBrowserContextMenu 获取或初始化设置是否允许浏览器默认的上下文菜单。
enabled 获取控件是否可以对用户交互作出响应。如果该值为 true，则表示控件可以对用户交互作出响应；反之则不能。 请使用 setEnabled 方法设置该字段的值。@default true
eTag 获取控件的标签。
height 获取控件的高度。可以是数字（如 500）、字符串（如“500px”）。请使用 setHeight 方法设置该字段的值。
layoutConfigs 获取或者设置一个 JSON 对象，该属性表示控件在父容器中的布局配置参数。该属性只有在控件父容器运用布局器才会生效。
left 获取控件的左边界与父容器左边界的像素距离。请使用 setLeft 方法设置该字段的值。
padding 获取控件的内边距。如“4px”表示上下左右的内边距均为 4 像素； “4px 2px 3px 1px”则表示上边距为 4 像素，右边距为 2 像素，下边距为 3 像素，左边距为 1 像素。请使用 setPadding 方法设置该字段的值。
parent 获取控件所属的父对象。
permissionID 获取或设置一个字符串，表示控件的权限标识。
position 获取控件位置样式值。请使用 setPosition 方法设置该字段的值。

该字段的可选值包括:

  • relative
  • absolute
right 获取控件的右边界与父容器右边界的像素距离。请使用 setRight 方法设置该字段的值。
top 获取控件的上边界与父容器上边界的像素距离。请使用 setTop 方法设置该字段的值。
visible 获取一个 Boolean 值，表示控件是否可见。如果该值为 true，则表示控件可见；反之则不可见。请使用 setVisible 方法设置该字段的值。@default true
width 获取控件的宽度。可以是数字（如 500）、字符串（如“500px”或“50%”）。请使用 setWidth 方法设置该字段的值。
$e 获取该控件的占位符，该占位符为一个 JQuery 对象。

构造函数详细信息

Control() 方法

构建 Control 类的新实例。

初始化函数详细信息

init() 方法

方法详细信息

contains($p_target) 方法

返回一个 Boolean 值，该值表示控件的容器中是否包含该 JQuery 对象。

参数

  • $p_target
    一个 JQuery 对象，或 JQuery 选择器对应的字符串（如“#container”），或 HTML DOM 元素。

dispose() 方法

释放对象运行时动态生成的内容（属性、方法、事件）。

getContext() 方法

获取控件当前所属 Weblet 的上下文信息（ WebletContext 类型）。

getEl() 方法

获取控件容器对应的 HTML DOM 元素对象。

hide() 方法

隐藏控件，设置控件不可见。

moveTo(p_left, p_top) 方法

移动控件到指定位置。@param p_left 一个数字，表示 css 样式的 left 属性。 @param p_top 一个数字，表示 css 样式的 top 属性。

参数

  • p_left
    一个数字，表示 css 样式的 left 属性。
  • p_top
    一个数字，表示 css 样式的 top 属性。

resizeTo(p_width, p_height) 方法

重设控件的大小。@param p_width 控件的宽度，可以是数字（如 100），也可以是字符串（如 “100%”）。 @param p_height 控件的高度，可以是数字（如 100），也可以是字符串（如 “100%”）。

参数

  • p_width
    控件的宽度，可以是数字（如 100），也可以是字符串（如 “100%”）。
  • p_height
    控件的高度，可以是数字（如 100），也可以是字符串（如 “100%”）。

setBorder(p_border) 方法

设置控件的边框样式。@param p_border 一个字符串，表示css样式的 border 属性。

参数

  • p_border
    一个字符串，表示css样式的 border 属性。

setBottom(p_bottom) 方法

设置 bottom 字段的值。@param p_bottom 控件的下边界与父容器下边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。

参数

  • p_bottom
    控件的下边界与父容器下边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。

setCss(p_css) 方法

设置 css 字段的值。 @param p_css 一个 JSON 对象，表示控件的 CSS 样式。

参数

  • p_css
    一个 JSON 对象，表示控件的 CSS 样式。 {@exclude mx.datacontrols.ScrollBar}

setCssClass(p_cssClass) 方法

设置 cssClass 字段的值 @param p_cssClass 一个String 对象，样式classname

参数

  • p_cssClass
    一个String 对象，样式classname {@exclude mx.datacontrols.ScrollBar}

setDisplay(p_display) 方法

设置 display 字段的值。@param p_display css 样式的 display 属性。

参数

  • p_display
    css 样式的 display 属性。

setEnabled(p_enabled) 方法

设置 enabled 字段的值。

参数

  • p_enabled

setHeight(p_height) 方法

设置 height 字段的值。 注：子类UploadControl上传控件不支持百分比设置高度 @param p_height 控件的高度，可以是数字（如 100），也可以是字符串（如 “100%”）。

参数

  • p_height
    控件的高度，可以是数字（如 100），也可以是字符串（如 “100%”）。

setLeft(p_left) 方法

设置 left 字段的值。 @param p_left 控件的左边界与父容器左边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。

参数

  • p_left
    控件的左边界与父容器左边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。 {@exclude mx.datacontrols.ComplexForm} {@exclude mx.datacontrols.DataGridSearchBox} {@exclude mx.datacontrols.DynamicForm} {@exclude mx.datacontrols.SkinDataForm}

setPadding(p_padding) 方法

设置控件的内边距。@param p_padding 一个字符串，表示css样式的 padding 属性。

参数

  • p_padding
    一个字符串，表示css样式的 padding 属性。

setPosition(p_position) 方法

设置 position 字段的值。@param p_position 一个字符串，表示 css 样式的 position 属性。

参数

  • p_position
    一个字符串，表示 css 样式的 position 属性。

setRight(p_right) 方法

设置 right 字段的值。@param p_right 控件的右边界与父容器右边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。

参数

  • p_right
    控件的右边界与父容器右边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。

setTop(p_top) 方法

设置 top 字段的值。 @param p_top 控件的上边界与父容器上边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。

参数

  • p_top
    控件的上边界与父容器上边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。 {@exclude mx.datacontrols.ComplexForm} {@exclude mx.datacontrols.DataGridSearchBox} {@exclude mx.datacontrols.DynamicForm} {@exclude mx.datacontrols.SkinDataForm}

setVisible(p_visible) 方法

设置 visible 字段的值。@param p_visible 一个 Boolean 值，表示控件是否可见。

参数

  • p_visible
    一个 Boolean 值，表示控件是否可见。

setWidth(p_width) 方法

设置 width 字段的值。@param p_width 控件的高度,可以是数字（如 500）、字符串（如“500px”或“50%”）.

参数

  • p_width
    控件的高度,可以是数字（如 500）、字符串（如“500px”或“50%”）.

show() 方法

显示控件，设置控件可见。

$(p_expression) 方法

该方法与 me.$e.find(p_expression) 等同。

参数

  • p_expression

$wrap([p_obj]) 方法

返回一个 JQuery 对象。

参数

  • p_obj
    可选的。默认值为“me.$e”。一个 JQuery 对象，或继承自 Control 的控件，或字符串，或 HTML DOM 元素。 如果参数为 JQuery 对象，则返回本身； 如果参数为继承自 Control 的控件，则返回控件的 $e 对象； 如果参数为字符串，则返回以字符串为选择器的 JQuery 对象； 如果参数为空，则返回控件本身的 $e 对象。

字段详细信息

alias 字段

获取或设置一个字符串，表示控件的别名。

border 字段

获取控件的边框样式。如“1px solid red”，表示边框的样式为 1 像素红色的实线。请使用 setBorder 方法设置该字段的值。

bottom 字段

获取控件的下边界与父容器下边界的像素距离。请使用 setBottom 方法设置该字段的值。

cssClass 字段

指定css伪类名称，设置控件显示样式

display 字段

获取控件的显示样式值。如“none”，表示隐藏控件； “block”表示强制作为块对象呈递。请使用 setDisplay方法设置该字段的值。

enableBrowserContextMenu 字段

获取或初始化设置是否允许浏览器默认的上下文菜单。

enabled 字段

获取控件是否可以对用户交互作出响应。如果该值为 true，则表示控件可以对用户交互作出响应；反之则不能。 请使用 setEnabled 方法设置该字段的值。@default true

默认值

true

eTag 字段

获取控件的标签。

默认值

<div/>

height 字段

获取控件的高度。可以是数字（如 500）、字符串（如“500px”）。请使用 setHeight 方法设置该字段的值。

layoutConfigs 字段

获取或者设置一个 JSON 对象，该属性表示控件在父容器中的布局配置参数。该属性只有在控件父容器运用布局器才会生效。

left 字段

获取控件的左边界与父容器左边界的像素距离。请使用 setLeft 方法设置该字段的值。

padding 字段

获取控件的内边距。如“4px”表示上下左右的内边距均为 4 像素； “4px 2px 3px 1px”则表示上边距为 4 像素，右边距为 2 像素，下边距为 3 像素，左边距为 1 像素。请使用 setPadding 方法设置该字段的值。

parent 字段

获取控件所属的父对象。

permissionID 字段

获取或设置一个字符串，表示控件的权限标识。

position 字段

获取控件位置样式值。请使用 setPosition 方法设置该字段的值。

该字段的可选值包括:

  • relative
  • absolute

right 字段

获取控件的右边界与父容器右边界的像素距离。请使用 setRight 方法设置该字段的值。

top 字段

获取控件的上边界与父容器上边界的像素距离。请使用 setTop 方法设置该字段的值。

visible 字段

获取一个 Boolean 值，表示控件是否可见。如果该值为 true，则表示控件可见；反之则不可见。请使用 setVisible 方法设置该字段的值。@default true

默认值

true

width 字段

获取控件的宽度。可以是数字（如 500）、字符串（如“500px”或“50%”）。请使用 setWidth 方法设置该字段的值。

$e 字段

获取该控件的占位符，该占位符为一个 JQuery 对象。