全称 mx.containers.TabControl
命名空间 mx.containers
TabControl
继承层次结构 TabControlContainerControl
源文件 ~\mx\scripts\containers\TabControl.js
提供一个分页控件。

示例 1

以下是一个创建 TabControl 的示例。 该示例将说明如何创建一个 TabControl,如何添加 TabPage 页,以及如何订购事件。
JavaScript 代码
var tabControl = new mx.containers.TabControl({ pages:[ { text: "常规", name: "general" }, { text: "角色", name: "role" } ], onselectionchanging: _selection_changing, onselectionchanged: _selection_changed }); function _selection_changing(e) { if (!confirm("确定需要更改选择项?")) { e.cancel = true; } } function _selection_changed() { alert("选择页发生了改变,当前选择项为:" + tabControl.selection.text); }

构造函数

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

初始化函数

名称 说明
init() 初始化方法。执行设置样式并初始化属性等操作。

方法

名称 说明
appendPage(p_page) TabControl 的页集合(pages 集合)中添加新页,并返回该 TabPage 对象。
appendPage(p_name, p_text, p_closable) TabControl 的页集合(pages 集合)中添加新页,并返回该 TabPage 对象。
appendPages(p_pages) TabControl 的页集合(pages 集合)中添加一组页。
clear() 容器的dispose方法
clearPages() pages 集合中移除所有项。若要从 TabControl 中移除单个项,请使用 removePage 方法。
contains($p_target) 返回一个 Boolean 值,该值表示控件的容器中是否包含该 JQuery 对象。
dispose() Container中移除该TabControl实例
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 中移除,但仍驻留在内存中,可以重用。
removeOtherPages() pages 集合中移除除了当前选中的项以外的所有项。
removePage(p_page) pages 集合中移除指定的 TabPage 对象,若该页是控件当前的显示页,则会自动选择第一页,并触发 onselectionchanged 事件。从集合中移除页时,有关移除的页的所有信息均会被删除。
resizeTo(p_width, p_height) 重设控件的大小。@param p_width 控件的宽度,可以是数字(如 100),也可以是字符串(如 “100%”)。 @param p_height 控件的高度,可以是数字(如 100),也可以是字符串(如 “100%”)。
selectPage(p_page, [p_triggerEvent]) 选择并显示 TabControl 页集合中的指定页。
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 字段的值。
setHeaderVisible([p_headerVisible]) 设置 headerVisible 字段的值。
setHeight(p_height) 设置 height 字段的值。 注:子类UploadControl上传控件不支持百分比设置高度 @param p_height 控件的高度,可以是数字(如 100),也可以是字符串(如 “100%”)。
setLeft(p_left) 设置 left 字段的值。 @param p_left 控件的左边界与父容器左边界的像素距离,可以是数字(如 50),也可以是字符串(如 50%)。
setPadding(p_padding) 设置 $body 对象的内边距。
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
controls 获取容器包含的控件集合。集合中的单个控件也可能是一个容器。请使用 addControlremoveControl 方法向集合中添加或移除控件。
cssClass 指定css伪类名称,设置控件显示样式
display 获取控件的显示样式值。如“none”,表示隐藏控件; “block”表示强制作为块对象呈递。请使用 setDisplay方法设置该字段的值。
displayIcon 获取或设置一个Boolean值,该值表示是否显示标签图标。
enableBrowserContextMenu 获取或初始化设置是否允许浏览器默认的上下文菜单。
enabled 获取控件是否可以对用户交互作出响应。如果该值为 true,则表示控件可以对用户交互作出响应;反之则不能。 请使用 setEnabled 方法设置该字段的值。@default true
enableMxTabHideMode 获取或设置选项卡的隐藏模式是否应用全局的$MX_TAB_HIDEMODE变量。 可设的值为。
  • true 表示隐藏模式会应用$MX_TAB_HIDEMODE变量。
  • false 表示隐藏模式不会应用$MX_TAB_HIDEMODE变量。
eTag 获取控件的标签。
headerVisible 获取或设置一个 Boolean 值,该值表示是否显示控件的分页按钮。 该字段必须在初始化前设置。控件初始化后请使用 setHeaderVisible 方法设置该字段的值。
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 对象,该属性表示控件在父容器中的布局配置参数。该属性只有在控件父容器运用布局器才会生效。
left 获取控件的左边界与父容器左边界的像素距离。请使用 setLeft 方法设置该字段的值。
padding 获取控件的内边距。如“4px”表示上下左右的内边距均为 4 像素; “4px 2px 3px 1px”则表示上边距为 4 像素,右边距为 2 像素,下边距为 3 像素,左边距为 1 像素。请使用 setPadding 方法设置该字段的值。
pages 获取一个集合,包含控件中所有的页(TabPage 类型)。
parent 获取控件所属的父对象。
permissionID 获取或设置一个字符串,表示控件的权限标识。
position 详见 Control.position 属性。
right 获取控件的右边界与父容器右边界的像素距离。请使用 setRight 方法设置该字段的值。
selection 获取一个对象,表示 TabControl 中当前显示的页(TabPage 类型)。
tabHideMode 获取或设置选项卡的隐藏模式。 可设的值为。
  • detach 表示标签切换为非选中状态时将标签体从当前 DOM 上下文中移除。
  • hide 表示标签切换为非选中状态时将标签体从当前 DOM 上下文中隐藏。
top 获取控件的上边界与父容器上边界的像素距离。请使用 setTop 方法设置该字段的值。
visible 获取一个 Boolean 值,表示控件是否可见。如果该值为 true,则表示控件可见;反之则不可见。请使用 setVisible 方法设置该字段的值。@default true
width 获取容器的宽度。可以是数字(如 500)、字符串(如“500px”或“50%”)。
$body 获取一个 JQuery 对象,该对象用于显示每页的内容。
$container 获取容器控件中用来包含控件 DOM 元素的占位符。
$e 获取该控件的占位符,该占位符为一个 JQuery 对象。
$head 获取一个 JQuery 对象,该对象用于显示分页按钮。

事件

名称 说明
oncontextmenu 在弹出上下之前执行 传入执行方法中参数为 {cancel:false,event:e}; cancel如果为true会中断默认逻辑的执行,event为事件参数
onctrladded 当添加控件到容器后,将触发该事件。
onctrlremoved 当从容器移除控件后,将触发该事件。
onselectionchanged 当控件的显示页发生改变后,将触发该事件。调用 selectPage(p_page, true) 方法后会触发该事件。
onselectionchanging 当控件的显示页发生改变的时候,将触发该事件。调用 selectPage 方法时会触发该事件。

构造函数详细信息

TabControl() 方法

构建 TabControl 类的新实例。

初始化函数详细信息

init() 方法

初始化方法。执行设置样式并初始化属性等操作。

继承自


方法详细信息

appendPage(p_page) 方法

TabControl 的页集合(pages 集合)中添加新页,并返回该 TabPage 对象。

参数

  • p_page
    一个 JSON 对象或一个 TabPage 对象,表示要添加的新页。

示例 1

以下是为 TabControl 添加一个 TabPage 的示例。
JavaScript 代码
tabControl.appendPage("job", "职位"); // tabControl 为一个 TabControl 实例对象,“职位”为 TabPage 的“text”属性值,“job”为 TabPage 的“name”属性值

appendPage(p_name, p_text, p_closable) 方法

TabControl 的页集合(pages 集合)中添加新页,并返回该 TabPage 对象。

参数

  • p_name
    一个字符串(不能是全为数字的字符串,必须包含一个非数字字符),表示该页的名称。TabPage.name 字段也是所有页的唯一标识,必须唯一。
  • p_text
    一个字符串,表示该页的按钮上显示的文本。
  • p_closable
    一个Boolean值,表示该页是否可以关闭。

示例 1

以下是为 TabControl 添加一个 TabPage 的示例。
JavaScript 代码
tabControl.appendPage("job", "职位"); // tabControl 为一个 TabControl 实例对象,“职位”为 TabPage 的“text”属性值,“job”为 TabPage 的“name”属性值

appendPages(p_pages) 方法

TabControl 的页集合(pages 集合)中添加一组页。

参数

  • p_pages
    一个数组,该数组包含了一组 TabPage 对象。

示例 1

以下是为 TabControl 添加一组 TabPage 的示例。
JavaScript 代码
tabControl.appendPages([ { text: "职位", name: "job", closable: true}, { text: "岗位", name: "position", imageKey: "position_16" } ]);

clear() 方法

容器的dispose方法

继承自


clearPages() 方法

pages 集合中移除所有项。若要从 TabControl 中移除单个项,请使用 removePage 方法。

contains($p_target) 方法

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

参数

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

继承自


dispose() 方法

Container中移除该TabControl实例

继承自


findControl(p_alias) 方法

根据指定的控件属性及属性值查找当前视图中对应的控件。 如果仅传入一个参数,则默认将该参数作为别名的值进行查找。 @overload function(p_alias) @param p_alias 一个字符串,表示控件的别名。 @overload function(p_attrName, p_attrValue) @param p_attrName 一个字符串,表示控件的属性名。 @param p_attrValue 一个字符串,表示控件的属性值。

参数

  • p_alias
    一个字符串,表示控件的别名。

继承自


findControl(p_attrName, p_attrValue) 方法

根据指定的控件属性及属性值查找当前视图中对应的控件。 如果仅传入一个参数,则默认将该参数作为别名的值进行查找。 @overload function(p_alias) @param p_alias 一个字符串,表示控件的别名。 @overload function(p_attrName, p_attrValue) @param p_attrName 一个字符串,表示控件的属性名。 @param p_attrValue 一个字符串,表示控件的属性值。

参数

  • p_attrName
    一个字符串,表示控件的属性名。
  • p_attrValue
    一个字符串,表示控件的属性值。 {@exclude mx.datacontrols.DynamicForm}

继承自


findControlByPermissionID(p_permissionID) 方法

根据指定的权限标识查找当前视图中对应的控件。

参数

  • p_permissionID
    一个字符串,表示控件的权限标识。

继承自


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 属性。

继承自


removeControl(p_control, p_deep) 方法

controls 集合中移除指定的 Control 对象。 从集合中移除控件时,该控件会被从上下文的 DOM 中移除,但仍驻留在内存中,可以重用。

参数

  • p_control
    一个 Control 对象。
  • p_deep
    表示是否从内存中删除指定控件。

继承自


removeOtherPages() 方法

pages 集合中移除除了当前选中的项以外的所有项。

removePage(p_page) 方法

pages 集合中移除指定的 TabPage 对象,若该页是控件当前的显示页,则会自动选择第一页,并触发 onselectionchanged 事件。从集合中移除页时,有关移除的页的所有信息均会被删除。

参数

  • p_page
    一个数字(如 0),表示 pages 集合中页的序号;或一个字符串,表示页的唯一标识(TabPage.name 字段);或者一个 TabPage 对象。

resizeTo(p_width, p_height) 方法

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

参数

  • p_width
    控件的宽度,可以是数字(如 100),也可以是字符串(如 “100%”)。
  • p_height
    控件的高度,可以是数字(如 100),也可以是字符串(如 “100%”)。

继承自


selectPage(p_page, [p_triggerEvent]) 方法

选择并显示 TabControl 页集合中的指定页。

参数

  • p_page
    一个数字(如 0),表示 pages 集合中页的序号;或一个字符串,表示页的唯一标识(TabPage.name 字段);或者一个 TabPage 对象。
  • p_triggerEvent
    可选的。默认值为“false”。一个 Boolean 值,表示是否要触发 onselectionchanged 事件。如果该值为 true,则触发事件;反之则不触发。

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

继承自


setHeaderVisible([p_headerVisible]) 方法

设置 headerVisible 字段的值。

参数

  • p_headerVisible
    可选的。默认值为“true”。一个 Boolean 值,表示是否显示控件的分页按钮。如果该值为 true,表示显示分页按钮;反之则不显示。

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) 方法

设置 $body 对象的内边距。

参数

  • 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 方法设置该字段的值。

继承自


contextMenu 字段

获取或设置容器的上下文菜单。@default null

继承自

默认值

null

controls 字段

获取容器包含的控件集合。集合中的单个控件也可能是一个容器。请使用 addControlremoveControl 方法向集合中添加或移除控件。

继承自

集合

该字段是一个集合数组字段。 集合中成员的类型为 mx.controls.Control

集合索引

控件在集合中的序号(从 0 开始计数)。

cssClass 字段

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

继承自


display 字段

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

继承自


displayIcon 字段

获取或设置一个Boolean值,该值表示是否显示标签图标。

默认值

false

enableBrowserContextMenu 字段

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

继承自


enabled 字段

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

继承自

默认值

true

enableMxTabHideMode 字段

获取或设置选项卡的隐藏模式是否应用全局的$MX_TAB_HIDEMODE变量。 可设的值为。
  • true 表示隐藏模式会应用$MX_TAB_HIDEMODE变量。
  • false 表示隐藏模式不会应用$MX_TAB_HIDEMODE变量。

默认值

true

eTag 字段

获取控件的标签。

继承自

默认值

<div/>

headerVisible 字段

获取或设置一个 Boolean 值,该值表示是否显示控件的分页按钮。 该字段必须在初始化前设置。控件初始化后请使用 setHeaderVisible 方法设置该字段的值。

默认值

true

height 字段

获取容器的高度。可以是数字(如 500)、字符串(如“500px”或“50%”)。

继承自

默认值

100%

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);

继承自

示例 1

下面是一个绝对定位布局的容器添加控件的示例:
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);

示例 2

下面是一个锚定布局的容器添加控件的示例:
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);

layoutConfigs 字段

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

继承自


left 字段

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

继承自


padding 字段

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

继承自


pages 字段

获取一个集合,包含控件中所有的页(TabPage 类型)。

集合

该字段是一个集合数组字段。 集合中成员的类型为 mx.containers.TabPage

集合索引

页的名称(TabPage.name)或页在集合中的序号(从 0 开始计数)。

parent 字段

获取控件所属的父对象。

继承自


permissionID 字段

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

继承自


position 字段

详见 Control.position 属性。

继承自

默认值

relative

right 字段

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

继承自


selection 字段

获取一个对象,表示 TabControl 中当前显示的页(TabPage 类型)。

tabHideMode 字段

获取或设置选项卡的隐藏模式。 可设的值为。
  • detach 表示标签切换为非选中状态时将标签体从当前 DOM 上下文中移除。
  • hide 表示标签切换为非选中状态时将标签体从当前 DOM 上下文中隐藏。

默认值

detach

top 字段

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

继承自


visible 字段

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

继承自

默认值

true

width 字段

获取容器的宽度。可以是数字(如 500)、字符串(如“500px”或“50%”)。

继承自

默认值

100%

$body 字段

获取一个 JQuery 对象,该对象用于显示每页的内容。

$container 字段

获取容器控件中用来包含控件 DOM 元素的占位符。

继承自


$e 字段

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

继承自


$head 字段

获取一个 JQuery 对象,该对象用于显示分页按钮。

事件详细信息

oncontextmenu 事件

在弹出上下之前执行 传入执行方法中参数为 {cancel:false,event:e}; cancel如果为true会中断默认逻辑的执行,event为事件参数

继承自


onctrladded 事件

当添加控件到容器后,将触发该事件。

参数

  • ctrl
    一个 Control 类型或子类型对象。

继承自


onctrlremoved 事件

当从容器移除控件后,将触发该事件。

参数

  • ctrl
    一个 Control 类型或子类型对象。

继承自


onselectionchanged 事件

当控件的显示页发生改变后,将触发该事件。调用 selectPage(p_page, true) 方法后会触发该事件。

参数

  • page
    一个 TabPage 对象,即将被选择并显示的选项卡页。

onselectionchanging 事件

当控件的显示页发生改变的时候,将触发该事件。调用 selectPage 方法时会触发该事件。

参数

  • cancel
    可通过设置 cancel 参数为 true 来取消当前操作。默认为 false。
  • page
    一个 TabPage 对象,即将被选择并显示的选项卡页。