构建 VSplit 类的新实例。
| 全称 | mx.containers.VSplit |
| 命名空间 | mx.containers |
| 类 | VSplit |
| 继承层次结构 | VSplitSplitContainerControl |
| 源文件 | ~\mx\scripts\containers\VSplit.js |
| JavaScript 代码 |
var vSplit = new mx.containers.VSplit({
height:"500px",
width:"100%"
});
var btnLeft = new mx.controls.Button({text:"我在左边"});
var btnRight = new mx.controls.Button({text:"我在右"});
//向左边容器加入一个按钮
vSplit.addControl(btnLeft, 0);
//向右边容器加入一个按钮
vSplit.addControl(btnRight, 1); |
| JavaScript 代码 |
var vSplit = new mx.containers.VSplit({
cols:"20%, 80%"
}); |
| 名称 | 说明 |
| VSplit() | 构建 VSplit 类的新实例。 |
| 名称 | 说明 |
| init() | 初始化方法。执行设置样式并初始化属性等操作。 |
| 名称 | 说明 |
| addControl(p_control, [p_index], [p_islinebreak]) | 详见 Container.addControl 方法。 |
| addControls(p_controls, [p_index], [p_islinebreak]) | 将一组 Control 对象添加到集合 controls 中。 |
| append($p_obj, [p_index]) | 详见 Container.append 方法。 |
| clear() | 容器的dispose方法 |
| collapse() | 隐藏指定的面板（通过 activePanelIndex 属性设置可展开的面板）。 |
| contains($p_target) | 返回一个 Boolean 值，该值表示控件的容器中是否包含该 JQuery 对象。 |
| dispose() | 释放对象运行时动态生成的内容（属性、方法、事件）。 |
| expand() | 展开指定的面板（通过 activePanelIndex 属性设置可展开的面板）。 |
| 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 属性。 |
| setBorderThick(p_borderThick) | 设置字段 borderThick 的值。 |
| 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) | 设置控件的内边距。 {@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() | 显示控件，设置控件可见。 |
| toggleExpanded() | 切换指定面板的显示状态（展开或隐藏）。 |
| $(p_expression) | 该方法与 me.$e.find(p_expression) 等同。 |
| $wrap([p_obj]) | 返回一个 JQuery 对象。 |
| 名称 | 说明 |
| activePanelIndex | 获取或设置哪个面板可隐藏或展开。 该值为一个数字，表示控件中哪个 Panel 的索引（如果是 VSplit，“0”表示左边的 Panel，“1”表示右边的 Panel。如果是 HSplit，“0”表示上面的 Panel，“1”表示下面的 Panel）。 |
| alias | 获取或设置一个字符串，表示控件的别名。 |
| border | 获取控件的边框样式。如“1px solid red”，表示边框的样式为 1 像素红色的实线。请使用 setBorder 方法设置该字段的值。 |
| borderThick | 获取和设置边框粗细，一个数字（如 1、0）或字符串（如“2px”、“5px”）。 |
| bottom | 获取控件的下边界与父容器下边界的像素距离。请使用 setBottom 方法设置该字段的值。 |
| cols | 获取一个字符串，表示 VSplit 的面板个数以及每个面板的宽度（如“100,auto”，表示有两个面板，第一个面板宽度为 “100px”，第二个的面板宽度自适应；暂不支持“auto,100”的格式，即第一个为 auto，第二个为数字或百分比）。 |
| contextMenu | 获取或设置容器的上下文菜单。@default null |
| controls | 获取容器包含的控件集合。集合中的单个控件也可能是一个容器。请使用 addControl 和 removeControl 方法向集合中添加或移除控件。 |
| cssClass | 指定css伪类名称，设置控件显示样式 |
| display | 获取控件的显示样式值。如“none”，表示隐藏控件； “block”表示强制作为块对象呈递。请使用 setDisplay方法设置该字段的值。 |
| enableBrowserContextMenu | 获取或初始化设置是否允许浏览器默认的上下文菜单。 |
| enabled | 获取控件是否可以对用户交互作出响应。如果该值为 true，则表示控件可以对用户交互作出响应；反之则不能。 请使用 setEnabled 方法设置该字段的值。@default true |
| eTag | 获取控件的标签。 |
| expanded | 获取一个 Boolean 值，表示索引值为 {@activePanelIndex} 的面板是否展开。 |
| height | 获取容器的高度。可以是数字（如 500）、字符串（如“500px”或“50%”）。 |
| layoutConfigs | 获取或者设置一个 JSON 对象，该属性表示控件在父容器中的布局配置参数。该属性只有在控件父容器运用布局器才会生效。 |
| left | 获取控件的左边界与父容器左边界的像素距离。请使用 setLeft 方法设置该字段的值。 |
| orientation | 请参见 Split.orientation 字段。 |
| padding | 获取控件的内边距。如“4px”表示上下左右的内边距均为 4 像素。 |
| parent | 获取控件所属的父对象。 |
| permissionID | 获取或设置一个字符串，表示控件的权限标识。 |
| position | 详见 Control.position 属性。 |
| resizable | 获取一个 Boolean 值，表示是否可以由用户以拖动方式改变容器面板大小。该字段必须在初始化前设置。 |
| right | 获取控件的右边界与父容器右边界的像素距离。请使用 setRight 方法设置该字段的值。 |
| splitOptions | 获取一个 JSON 对象，该属性表示 Split 的两个面板的尺寸信息。例如 { panel1: “30%”， panel2: "auto"} 表示 panel1的高度（宽度）为 70%, panel2的高度（宽度）自适应。 该属性由 HSplit 的 {@mx.containers.HSplit.rows} 属性 或者 VSplit 的 {@mx.containers.VSplit.cols} 属性决定。 |
| threshold | 获取和设置面板拖拽时的上阈值和下阈值,该属性通常是一个数字或者数组。当为数字时，表示上下（左右）阈值都为相同值；当数组时，数组的第一个元素表示上（左）阈值，数组的第二个元素表示下（右）阈值。 |
| top | 获取控件的上边界与父容器上边界的像素距离。请使用 setTop 方法设置该字段的值。 |
| visible | 获取一个 Boolean 值，表示控件是否可见。如果该值为 true，则表示控件可见；反之则不可见。请使用 setVisible 方法设置该字段的值。@default true |
| width | 获取容器的宽度。可以是数字（如 500）、字符串（如“500px”或“50%”）。 |
| $container | 获取容器控件中用来包含控件 DOM 元素的占位符。 |
| $e | 获取该控件的占位符，该占位符为一个 JQuery 对象。 |
| 名称 | 说明 |
| oncontextmenu | 在弹出上下之前执行 传入执行方法中参数为 {cancel:false,event:e}; cancel如果为true会中断默认逻辑的执行，event为事件参数 |
| onctrladded | 当添加控件到容器后，将触发该事件。 |
| onctrlremoved | 当从容器移除控件后，将触发该事件。 |
| onresize | 当容器内面板大小发生改变时触发该事件。 |
| onresizing | 当容器内面板大小发生改变前触发该事件。 |