Input

含义: 输入对象的属性；数量: 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的图片文件

备注1: 如果设定了LeftText，那么必须设定 LeftSize 或 EditSize (只要有其一即可)，否则无法保证输入框在垂直方向的对齐;
备注2: 下拉Treelist也可以不采用droplistID，而使用诸如treelistURL、DataCol、DisplayCol属性以自行指定下拉Treelist;
备注3: leftText、text、tip允许以"|"分隔中英文(用于中英文切换);