构建 LabelEditor 类的新实例。
全称 | mx.editors.LabelEditor |
命名空间 | mx.editors |
类 | LabelEditor |
继承层次结构 | LabelEditorEditorControl |
源文件 | ~\mx\scripts\editors\LabelEditor.js |
JavaScript 代码 |
var labelEditor = new mx.editors.LabelEditor({
value: "我是标签",
onchanged: _labelEditor_changed
});
function _labelEditor_changed(e)
{
alert(e.target.value);
} |
名称 | 说明 |
LabelEditor() | 构建 LabelEditor 类的新实例。 |
名称 | 说明 |
init() | 初始化方法。执行设置样式并初始化属性等操作。 |
名称 | 说明 |
alias | 获取或设置一个字符串,表示控件的别名。 |
autoWrap | 获取一个 Boolean 值,表示标签编辑器文本是否自动换行。 |
border | 获取一个字符串,表示 LabelEditor 边框样式。请通过 setBorder 方法设置该字段的值。 |
bottom | 获取控件的下边界与父容器下边界的像素距离。请使用 setBottom 方法设置该字段的值。 |
cssClass | 指定css伪类名称,设置控件显示样式 |
customValidate![]() |
自定义验证规则。 可通过重写该方法实现自定义验证的效果。 返回的结果为一个 Boolean 值或者一个 JSON 对象。如“true”、“false”或者“{ successful: false, hint: "验证失败!" }”。 如果返回的是 JSON 对象,“successful”表示是否成功,“hint”表示显示值。 |
differDisplayValue | 获取编辑器的显示值是否与实际值相同。例如,当 {@link DropDownList} 控件的 displayMember 字段和 valueMember 字段不同时,该字段为 true;而多数情况下该字段为 false。 该字段通常由具体的编辑器设定,请不要在程序中直接修改。 |
display | 获取控件的显示样式值。如“none”,表示隐藏控件; “block”表示强制作为块对象呈递。请使用 setDisplay。注:该"block"值不能在ComplexGrid控件中使用。 方法设置该字段的值。 |
displayInline | 获取一个 Boolean 值,表示标签编辑器和旁边的控件是否呈递在同一行内。请使用 setDisplayInline 方法设置该字段的值。 |
enabled | 获取控件是否可以对用户交互作出响应。如果该值为 true,则表示控件可以对用户交互作出响应;反之则不能。 请使用 setEnabled 方法设置该字段的值。 |
enableEventOnInit | 一个布尔值,指示在me.init方法中是否触发changed事件,默认是触发的。 |
eTag | 获取控件的标签。 |
formatString | 获取编辑器的日期(如“yyyy-MM-dd”)或数字(如“0.00”)格式化字符串。 请使用 setFormatString 方法设置该字段的值。 |
height | 获取控件的高度。可以是数字(如 500)、字符串(如“500px”或“50%”)。请使用 setHeight 方法设置该字段的值。 |
isValidate | 获取一个 Boolean 值,表示编辑器是否通过验证。 |
layoutConfigs | 获取或者设置一个 JSON 对象,该属性表示控件在父容器中的布局配置参数。该属性只有在控件父容器运用布局器才会生效。 |
left | 获取控件的左边界与父容器左边界的像素距离。请使用 setLeft 方法设置该字段的值。 |
max | 获取编辑器允许的最大值(仅对 Number 类型有效)。 该字段必须在初始化前设置。 |
min | 获取编辑器允许的最小值(仅对 Number 类型有效)。 该字段必须在初始化前设置。 |
padding | 获取控件的内边距。如“4px”表示上下左右的内边距均为 4 像素; “4px 2px 3px 1px”则表示上边距为 4 像素,右边距为 2 像素,下边距为 3 像素,左边距为 1 像素。请使用 setPadding 方法设置该字段的值。 |
parent | 获取控件所属的父对象。 |
permissionID | 获取或设置一个字符串,表示控件的权限标识。 |
position | 获取控件位置样式值。如“static”,表示无特殊定位,对象遵循 HTML 定位规则。请使用 setPosition
方法设置该字段的值。
该字段的可选值包括:
|
readOnly | 获取编辑器是否只读。 请使用 setReadOnly 方法设置该字段的值。 请参考 isReadOnly 和 setReadOnly 方法。 |
right | 获取控件的右边界与父容器右边界的像素距离。请使用 setRight 方法设置该字段的值。 |
showTitle | 获取一个 Boolean 值,表示光标移动到标签编辑器上时是否显示提示信息。请使用 setShowTitle 方法设置该字段的值。 |
text | 获取编辑器的文本值。 请使用 setText 方法设置该字段的值。 |
textAlign | 获取标签编辑器的文本的左右对齐方式。如“left”,表示靠右对齐。请使用 setTextAlign 方法设置该字段的值。
该字段的可选值包括:
|
tipPosition | 获取或设置一个字符串,表示编辑器未通过校验时,提示信息的位置。
该字段可选的值包括:
|
top | 获取控件的上边界与父容器上边界的像素距离。请使用 setTop 方法设置该字段的值。 |
validateMessage | 获取编辑器验证提示信息。 |
validOptions | 设置和获取校验参数。该属性与 validType配合使用。常用参数请参见 ValidatorClass.validator 的 p_options。 |
validType![]() |
获取或设置一个字符串,表示验证类型。
该字段可选的值包括:
|
vAlign | 获取标签编辑器的文本的上下对齐方式。如“middle”,表示居中对齐。请使用 setVAlign 方法设置该字段的值。
该字段的可选值包括:
|
value | 获取编辑器的值。 请使用 setValue 方法设置该字段的值。 |
valueType | 获取一个字符串,表示 value 的数据类型。
该字段必须在初始化前设置。
该字段可选的值包括:
|
visible | 获取一个 Boolean 值,表示控件是否可见。如果该值为 true,则表示控件可见;反之则不可见。请使用 setVisible 方法设置该字段的值。 |
width | 获取控件的宽度。可以是数字(如 500)、字符串(如“500px”或“50%”)。请使用 setWidth 方法设置该字段的值。 |
$e | 获取该控件的占位符,该占位符为一个 JQuery 对象。 |
JavaScript 代码 |
var editor = new mx.editors.TextEditor({
customValidate:function(p_editor){
// TODO: 验证逻辑
// 如果没有验证通过
return { successful:false, hint:"验证失败!" }
}
}); |
该字段的可选值包括:
该字段可选的值包括:
JavaScript 代码 |
var editor = new mx.editors.TextEditor({
validType: "INTEGER" //验证输入值是整数
validOptions: {minValue: 12, maxValue: 20, validateMessage: "请输入正整数"}
}); |