含义: 输入对象的属性;数量: 0-n | |||||
属性名称 | 含义 | 可用值 | 默认值 | 示例 | |
type 或 editType | 输入控件类型 | Edit - 最普通、允许EditMask的编辑; EditWithButton - 右侧有按钮的Edit; MultiLineEdit - 多行编辑(默认以Ctrl+Enter换行); Checkbox/Check - 复选框; RadioButton/Radio - 单选框; Button - 按钮; Droplist - 下拉列表; EditAbleDroplist - 可编辑的下拉列表; Droptreelist - 下拉嵌套的treelist; EditAbleDroptreelist - 可编辑的下拉嵌套treelist; Upload - 文件上传输入控件; password/pwd - 密码输入控件; | Edit | ||
tabOrder | 输入顺序 | 数字 | -1 | ||
enable | Enable | true/false/readonly(仅用于有输入框的input) | true | ||
editAble | 是否可输入 | true/false | true | ||
注: 对Button无效; | |||||
nullAble | 是否允许为空 | true/false | true | ![]() | |
注: 仅用于Edit、EditWithButton的等有输入框的对象 | |||||
align | 水平对齐 | left/center/right | 和数据类型有关 | ||
注: 对Button,checkbox,radiobutton无效; | |||||
leftText | 左侧文字 | 串 | (无) | ![]() | |
注: 对Button无效; | |||||
tip 或 toolTip | 鼠标滑过左侧文字时的黄底文字 | 串 | (无) | ||
注: 仅用于鼠标滑过 leftText 时 | |||||
leftTextAlign 或 alignLeftText | 左侧文字对齐 | left/center/right | right | ||
注: 对Button无效; | |||||
leftSize | 左侧文字宽度 | 如果Input是嵌在tableLayout中,表示跨越的列数(当 width>1 时), 否则表示像素数 | (无) | ![]() | |
注1: 如果是像素数, LeftSize, EditSize选其一即可; 注2: 对Button无效;; | |||||
editSize | 右侧输入框宽度 | 如果Input是嵌在tableLayout中,表示跨越的列数(当 width>1 时), 否则表示像素数 | (无) | ||
注1: 如果是像素数, LeftSize, EditSize选其一即可; 注2: 对Button无效;; | |||||
color 或 textColor | 左侧文字的颜色 | 颜色串 | #000000 | ||
注: 对Button无效; | |||||
fontIndex | 字体 | 数字,指向在<Fonts>中定义的字体的顺序号,从0开始计数 | 0 | ||
value | 初始值 | 串 | (无) | ![]() | |
border | 输入框的边框 | 空 - 有边界; none - 表示无边界; | (无) | ||
注: 对Button无效; | |||||
isSelectEditWhenFocus | 当输入框取得焦点时,光标是否选中全部文字 | true - 全选; false - 不选; auto - 自动, 表示为数值型(int、double)时全选; | 沿用<Properties> | ||
注: 仅用于Edit、EditWithButton的等有输入框的对象 | |||||
Droplist DropTreelist | droplistId | 下拉框的相关联的下拉资源ID | 串,该ID必须存在于下面的<Droplists>节点中 | (无) | ![]() |
freeInputAble | 输入内容是否受限 | true - 可任意输入,内容不受限制; false - 受Droplist中的dataCol、dispCol限制, 输入内容必须和dataCol、dispCol匹配, 否则输入无效; | false | ||
注: 仅用于EditAbleDropTreelist | |||||
emptyPrompt | 未输入时显示的提示 | 串,例如"-请输入-|-Input-" | (无) | ||
delayBeforeDropdown | BeforeDropdown事件重复触发的最短时间差 | 秒 | 0 | ||
dropdownWidth | 强制设定下拉窗的宽度 | 像素数或百分比 | (无) | ||
注: 百分比是指相对于输入框的宽度 | |||||
dropdownHeight | 强制设定下拉窗的高度 | 像素数或百分比 | (无) | ||
注: 百分比是指相对于屏幕的高度 | |||||
isDropDownWhenFocus | 是否得到焦点就自动弹出下拉 | true/false | false | ||
Edit | datatype | 数据类型 | string / int / double / bool / date / datetime | string | |
editmask | 日期型、数值型的输入掩码 | 对于日期型,例如YYYY.MM.DD hh:mm:ss 对于数值型,例如 ##,###,###.00 (表示千位符分隔、小数点2位)、 +00000 (表示最长5位的正整数)、#,###.#(表示千位符分隔、小数位数不确定) | (无) | ![]() | |
spin | 输入框内的垂直旋转滚动条 | true/false | 日期型是true | ![]() | |
注: 仅用于int、date、datetime型 | |||||
spinAsCalendar | 右侧显示下拉按钮、点击弹出日历 | true/false | false | ||
注1: 仅用于date、datetime型; 注2: spin="true"才生效; | |||||
max | 最大值 | 值串 | (无) | ![]() | |
注: 仅用于int、double、date、datetime型 | |||||
min | 最小值 | 值串 | (无) | ![]() | |
注: 仅用于int、double、date、datetime型 | |||||
maxChars | 字符串长度限定 | 长度限制,以Unicode计(中英文均以 '字' 为单位) | 0 | ![]() | |
注: 不能同时使用maxChars和maxMBytes, 仅用于string型 | |||||
maxMBytes | 字符串长度限定 | 长度限制,以字节计(中文算2字节、英文1字节) | 0 | ![]() | |
注: 不能同时使用maxChars和maxMBytes, 仅用于string型 | |||||
defaultValue | 初始值 | 支持以“=”开头的表达式 | (无) | ![]() | |
注: Input的“id”不得为空,否则无效 | |||||
startDate | 日期为空时,在输入时的起跳日期(即开始日期) | 日期串,例如"2015.1.1", 也可以是表达式, 例如=now('%Y-%m-%d') | 2000.1.1 | ||
注: 仅用于date、datetime型 | |||||
textId | 指定用于显示的数据列的列名(出现在数据的XML中) | 串 | (无) | ||
注: 可参考树列表中的同名属性 | |||||
EditWithButton | freeInputAble | 是否允许键盘输入 | true/false | true | |
注: 如果指定了droplistID(即绑定了字典),则强制为false | |||||
droplistId | 下拉资源ID,作为Key-Value的字典 | 串,该ID必须存在于下面的<Droplists>节点中, 也可以为"auto",表示自动创建一个空的下拉字典 | (无) | ||
image 或 img | 右侧按钮的图标 | URL | (无) | ||
textId | 指定用于显示的数据列的列名(出现在数据的XML中) | 串 | (无) | ||
MultiLineEdit | isWordWrap | 超宽时是否自动折行 | true/false | false | |
CheckBox | text | Checkbox的文字 | 串 | (无) | ![]() |
RadioButton | text | RadioButton的文字 | 串 | (无) | ![]() |
groupID | 分组的ID | 串,必需 | (无) | ![]() | |
selectValue | 真实的值 | 串, 用于GetChangedXML( )函数 | (无) | ![]() | |
Button | text 或 value | 按钮上的文字 | 串 | (无) | ![]() |
tip 或 toolTip | 鼠标滑过时的黄底文字 | 串 | (无) | ![]() | |
textColor | 文字颜色 | 颜色串 | #000000 | ![]() | |
style | 按钮的样式 | 为如下串的组合、逗号分隔: flat - 平坦的按钮,无凸起; transparent - 全透明的平坦按钮; round - 圆角矩形的平坦按钮; noMouseHover - 鼠标滑过时保持不变; | (无) | ![]() | |
bgColor 或 backColor | 自定义按钮色 | 颜色串,多个颜色间以逗号分隔,通常为1、3、4个颜色 | (无) | ![]() | |
icon 或 image 或 picture | 按钮小图标 | URL,支持图片扩展URL, 图片支持ico、bmp、jpg、png、gif | (无) | ![]() | |
at | 小图标相对于文字的位置 | left / right / top / bottom | left | ![]() | |
distance 或 dis | 小图标与文字的距离 | 像素数 | 4 | ![]() | |
isDrawDisableTextOnly | Disable时是否仅将文字作 disable 处理, 图片不作灰度处理 | true/false | false | ![]() | |
menuID | 下拉菜单ID | 指向菜单资源ID串,即<Menus> \ <Menu>的id | (无) | ![]() | |
isDynamicMenu | 是否动态下拉菜单 | true/false | false | ![]() | |
注: 所谓动态下拉菜单,是指单击后触发事件,由您自己在 js 中去动态配置菜单 | |||||
isMenuButtonStyle | 按钮右侧是否显示一个倒置的黑色小三角 | true/false | true | ||
注: 仅用于菜单按钮、或动态下拉菜单按钮 | |||||
enableDefaultMenu | 触发的点击事件, 是否区分按钮左侧、右侧部分 | true/false false - 不区分; true - 区分, 点击左侧和右侧,事件的参数有所差别; | false | ||
注1: 用于 isMenuButtonStyle=true、定义了 defaultMenuId 的菜单按钮; 注2: 用于 isMenuButtonStyle=true 的动态下拉菜单按钮; | |||||
defaultMenuId | 首选的子菜单的 Id (点击到按钮左侧部分时, 将触发 menuClicked 事件) | 子菜单的 Id | (无) | ||
注: 仅用于 isMenuButtonStyle=true、enableDefaultMenu=true 的菜单按钮 | |||||
Upload | fileTypes | 允许的文件类型 | 为文件后缀,后缀间以逗号分隔,如"bmp,jpg,png"。 后缀也可以是星号(*),例如"bmp,jpg, *",带星号表示允许选任何文件,前面的后缀只是起引导作用 | (无) | |
files | 文件个数限制 | 数字,0表示无限制 | 0 | ![]() | |
fileMaxKb | 单个文件的长度限制 | 数字,单位为KB,0表示不限制 | 0 | ||
pictureMaxSize | 图片文件的尺寸限制 | 2个数字,以逗号分隔,分别表示横向/纵向的像素数,0表示不限制 | 0,0 | ||
注: 只能辨认后缀是BMP、JPG、PNG、GIF、TIF的图片文件 |