构建 View 类的新实例。
全称 | mx.views.View |
命名空间 | mx.views |
类 | View |
继承层次结构 | ViewContainerControl |
源文件 | ~\mx\scripts\views\View.js |
名称 | 说明 |
View() | 构建 View 类的新实例。 |
名称 | 说明 |
init() | 初始化方法。执行设置样式并初始化属性等操作。 |
名称 | 说明 |
addControl(p_control, p_param, p_islinebreak) | 将 Control 对象添加到集合 controls 中。 |
addControls(p_controls) | 将一组 Control 对象添加到集合 controls 中。@param p_controls 一个 Control 控件数组。 |
append($p_obj) | 向容器中添加内容。@param $p_obj 一个 JQuery 对象,或一个控件(包含 $container 容器),或一个 HTML DOM 元素。 |
clear() | 容器的dispose方法 |
contains($p_target) | 返回一个 Boolean 值,该值表示控件的容器中是否包含该 JQuery 对象。 |
dispose() | 释放对象运行时动态生成的内容(属性、方法、事件)。 |
findControl(p_alias) | 根据指定的控件属性及属性值查找当前视图中对应的控件。 如果仅传入一个参数,则默认将该参数作为别名的值进行查找。 @overload function(p_alias) @param p_alias 一个字符串,表示控件的别名。 @overload function(p_attrName, p_attrValue) @param p_attrName 一个字符串,表示控件的属性名。 @param p_attrValue 一个字符串,表示控件的属性值。 |
findControl(p_attrName, p_attrValue) | 根据指定的控件属性及属性值查找当前视图中对应的控件。 如果仅传入一个参数,则默认将该参数作为别名的值进行查找。 @overload function(p_alias) @param p_alias 一个字符串,表示控件的别名。 @overload function(p_attrName, p_attrValue) @param p_attrName 一个字符串,表示控件的属性名。 @param p_attrValue 一个字符串,表示控件的属性值。 |
findControlByPermissionID(p_permissionID) | 根据指定的权限标识查找当前视图中对应的控件。 |
getContext() | 获取控件当前所属 Weblet 的上下文信息( WebletContext 类型)。 |
getEl() | 获取控件容器对应的 HTML DOM 元素对象。 |
hide() | 隐藏控件,设置控件不可见。 |
moveTo(p_left, p_top) | 移动控件到指定位置。@param p_left 一个数字,表示 css 样式的 left 属性。 @param p_top 一个数字,表示 css 样式的 top 属性。 |
removeControl(p_control, p_deep) | 从 controls 集合中移除指定的 Control 对象。 从集合中移除控件时,该控件会被从上下文的 DOM 中移除,但仍驻留在内存中,可以重用。 |
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%)。 |
setOverflow(p_value) | 提供一个方法,设置当对象的内容超过其指定高度及宽度时管理内容方式。 |
setOverflow(p_overflowType, p_value) | 提供一个方法,设置当对象的内容超过其指定高度及宽度时管理内容方式。 |
setPadding(p_padding) | 设置控件的内边距。 {@excude mx.containers.Wizard} |
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 方法设置该字段的值。 |
contextMenu | 获取或设置容器的上下文菜单。@default null |
controller | 获取视图控制器的实体引用,参见 ViewController。 |
controls | 获取容器包含的控件集合。集合中的单个控件也可能是一个容器。请使用 addControl 和 removeControl 方法向集合中添加或移除控件。 |
cssClass | 指定css伪类名称,设置控件显示样式 |
display | 获取控件的显示样式值。如“none”,表示隐藏控件; “block”表示强制作为块对象呈递。请使用 setDisplay方法设置该字段的值。 |
enableBrowserContextMenu | 获取或初始化设置是否允许浏览器默认的上下文菜单。 |
enabled | 获取控件是否可以对用户交互作出响应。如果该值为 true,则表示控件可以对用户交互作出响应;反之则不能。 请使用 setEnabled 方法设置该字段的值。@default true |
eTag | 获取控件的标签。 |
height | 获取容器的高度。可以是数字(如 500)、字符串(如“500px”或“50%”)。 |
layout![]() |
获取和设置一个容器控件的布局器。该字段可选的值包括:
@example
下面是一个绝对定位布局的容器添加控件的示例:
var container = new mx.containers.Container({
layout: "mx.layouts.AbsoluteLayout"
});
var textEditor = new mx.editors.TextEditor({
layoutConfigs: {
left: 100,
top: 50
}
});
container.addControl(textEditor);
@example
下面是一个锚定布局的容器添加控件的示例:
var container = new mx.containers.Container({
layout: "mx.layouts.AnchorLayout"
});
var textEditor1 = new mx.editors.TextEditor({
id: "editor1",
layoutConfigs: {
left: "100",
top: 50
}
});
container.addControl(textEditor1);
var textEditor2 = new mx.editors.TextEditor({
id: "editor2",
layoutConfigs: {
left: "editor1, 100px",//坐标值以逗号分隔,逗号之前是锚定对象的 id ,逗号之后表示相对于锚定对象的偏移。
top: 50,//如果不设置锚定对象,则以当前父容器为锚定对象。
bottom: "editor1, 100px"
}
});
container.addControl(textEditor2);
|
layoutConfigs | 获取或者设置一个 JSON 对象,该属性表示控件在父容器中的布局配置参数。该属性只有在控件父容器运用布局器才会生效。 |
layoutControl | 获取一个对象,表示布局器控件,控件的类型通过 layoutType 进行设置。 |
layoutOptions | 获取或设置一个 JSON 对象,表示布局器对象 layoutControl 的初始化参数。 |
layoutType | 获取或设置一个字符串,表示布局器的类型。
该类型可选的值包括:
|
left | 获取控件的左边界与父容器左边界的像素距离。请使用 setLeft 方法设置该字段的值。 |
padding | 获取控件的内边距。如“4px”表示上下左右的内边距均为 4 像素; “4px 2px 3px 1px”则表示上边距为 4 像素,右边距为 2 像素,下边距为 3 像素,左边距为 1 像素。请使用 setPadding 方法设置该字段的值。 |
parent | 获取控件所属的父对象。 |
permissionID | 获取或设置一个字符串,表示控件的权限标识。 |
position | 详见 Control.position 属性。 |
right | 获取控件的右边界与父容器右边界的像素距离。请使用 setRight 方法设置该字段的值。 |
top | 获取控件的上边界与父容器上边界的像素距离。请使用 setTop 方法设置该字段的值。 |
viewPort | 获取视图的视图容器,参见 ViewPort。 |
visible | 获取一个 Boolean 值,表示控件是否可见。如果该值为 true,则表示控件可见;反之则不可见。请使用 setVisible 方法设置该字段的值。@default true |
width | 获取容器的宽度。可以是数字(如 500)、字符串(如“500px”或“50%”)。 |
$container | 获取容器控件中用来包含控件 DOM 元素的占位符。 |
$e | 获取该控件的占位符,该占位符为一个 JQuery 对象。 |
名称 | 说明 |
onactivate | 当视图进入激活状态时触发该事件。在ViewPort.setView 方法中触发。 |
oncontextmenu | 在弹出上下之前执行 传入执行方法中参数为 {cancel:false,event:e}; cancel如果为true会中断默认逻辑的执行,event为事件参数 |
onctrladded | 当添加控件到容器后,将触发该事件。 |
onctrlremoved | 当从容器移除控件后,将触发该事件。 |
ondeactivate | 当视图进入非激活状态时触发该事件。在ViewPort.setView 方法中触发。 |
var container = new mx.containers.Container({
layout: "mx.layouts.AbsoluteLayout"
});
var textEditor = new mx.editors.TextEditor({
layoutConfigs: {
left: 100,
top: 50
}
});
container.addControl(textEditor);
@example
下面是一个锚定布局的容器添加控件的示例:
var container = new mx.containers.Container({
layout: "mx.layouts.AnchorLayout"
});
var textEditor1 = new mx.editors.TextEditor({
id: "editor1",
layoutConfigs: {
left: "100",
top: 50
}
});
container.addControl(textEditor1);
var textEditor2 = new mx.editors.TextEditor({
id: "editor2",
layoutConfigs: {
left: "editor1, 100px",//坐标值以逗号分隔,逗号之前是锚定对象的 id ,逗号之后表示相对于锚定对象的偏移。
top: 50,//如果不设置锚定对象,则以当前父容器为锚定对象。
bottom: "editor1, 100px"
}
});
container.addControl(textEditor2);
JavaScript 代码 |
var container = new mx.containers.Container({
layout: "mx.layouts.AbsoluteLayout"
});
var textEditor = new mx.editors.TextEditor({
layoutConfigs: {
left: 100,
top: 50
}
});
container.addControl(textEditor); |
JavaScript 代码 |
var container = new mx.containers.Container({
layout: "mx.layouts.AnchorLayout"
});
var textEditor1 = new mx.editors.TextEditor({
id: "editor1",
layoutConfigs: {
left: "100",
top: 50
}
});
container.addControl(textEditor1);
var textEditor2 = new mx.editors.TextEditor({
id: "editor2",
layoutConfigs: {
left: "editor1, 100px",//坐标值以逗号分隔,逗号之前是锚定对象的 id ,逗号之后表示相对于锚定对象的偏移。
top: 50,//如果不设置锚定对象,则以当前父容器为锚定对象。
bottom: "editor1, 100px"
}
});
container.addControl(textEditor2); |
该类型可选的值包括: