QQ
微信
1、昆仑通态触摸屏McgsPro软件动画构件功能概述
输入框构件用于接收用户从键盘输入的信息，通过合法性检查之后，将它转换适当的形式，赋予实时数据库中所连接的变量。输入框构件也可以作为数据输出的器件，显示所连接的变量的值。形象地说，输入框构件在用户窗口中提供了一个观察和修改实时数据库中变量的值的方法。
2、昆仑通态触摸屏McgsPro软件动画构件组态配置
组态过程中，用鼠标双击已经放置在用户窗口中的输入框构件，将弹出构件的属性设置对话框。本构件包括基本属性、操作属性、键盘属性和安全属性四个属性窗口页。
（1）基本属性页
基本属性窗口页组态内容如图1所示。
图1 输入框基本属性页
具体包括以下几项内容：
● 水平对齐：包括靠左、居中、靠右，是指输入框内的字符的显示方式。
● 垂直对齐：包括靠上、居中、靠下，是指输入框内的字符的显示方式。
● 边界类型：指定输入框构件的边界形式。其中“三维边框”是Windows95和WindowsNT下编辑框的标准外形，可以使整个界面具备三维效果；“无边框”则主要用于将输入框与其他图形元素组合起来，从而实现具有输入功能的复杂图形。
● 构件外观：包括背景颜色、字符颜色、使用图、显示效果预览。使用图是可选项，通过选择此项可以用图片作为输入框的背景（目前支持bmp,jpg,png,svg,ico格式图片）。
若勾选背景图功能，选择“图库”项，将显示如图2所示的对象元件库管理对话框.
图2 动画元件库
从对话框左边的对象元件列表中选择图片，选中的图片显示在对话框右边的显示框内。选择“确定”按钮，返回到输入框属性设置对话框，在输入框属性设置对话框中选择“确认”按钮后，输入框添加位图成功。用户还可以通过“对象元件库管理”中的装入按钮，添加图片到对象元件库。
（2）操作属性页
操作属性可指定被操作的变量的名称及其数值范围、数据格式，数据单位等，如图3所示。具体配置项如下：
● 对应数据对象的名称：本项内容必须设置，指定输入框构件所连接的变量名称。使用右侧的问号（“？”）按钮，可以方便地查找已经定义的所有变量，鼠标双击所要连接的变量，即可将其设置在栏内。可以连接的变量包括浮点数、整数和字符型三种类型。
● 数据单位：可配置项，若勾选此功能，输入单位字符串，运行时数据后会追加显示数据的单位，数据单位支持多语言，详情请参考第十三章。
● 数据格式：设定了此项后，数值将以设定的格式显示。
1）数据格式包括十进制、十六进制、二进制、自然小数、四舍五入、密码格式、zui小整数位数、固定小数位数，整数和浮点数根据关联变量自动调整。
2）当输入的整数位数小于设置的zui小整数位数时，数据通过前补零的方式调整整数位数。
3）当输入数据的小数位数超过设置的固定小数位数时可以采用四舍五入的方式输入。
4）密码格式项是指当输入字符型或自然小数格式数值数据时，数据在输入框内以“*”形式显示。当连接不同类型的变量时，可使用的数据格式也不同。
5）自然小数是指用户对小数位的格式不做特殊要求而让系统根据zui大有效位数(范围0到16，0表示6位有效数字)决定小数位精度，若用户需要指定小数位数，就要取消自然小数位，并在下面的小数位数输入框输入指定小数位，自然小数位和“四舍五入”选项互斥。
6）浮点数时，可选择自然小数位或设置“四舍五入”，数据默认以十进制形式显示；整数时，“十进制、十六进制、二进制”可以使用。任何数据类型，“密码格式”项均可以使用。
● 输入范围：本项对浮点数、整数变量有效，且只限制输入时数据范围而不限制显示的数据范围。设定了zui小值和zui大值也即确定了数值输入范围，超过了界限值，则运行时只取设定的界限值。zui小值和zui大值设定范围：负数是从-3.402823E38 到 -1.401298E-45，正数是从 1.401298E-45 到 3.402823E38，若zui小值大于zui大值时，zui小值为-3.40282E+38zui大值为3.40282E+38。
● 显示预览：设置时，可以通过此项预览显示效果。
图3 输入框操作属性页
注意：
1）输入框自然小数位输出时，显示精度为6位有效数字；
2）zui小整数位数，数据格式设置为十六进制时，zui小整数位数设置范围为1到8，数据格式设置为二进制时，zui小整数位数设置范围为1到32，数据格式设置为十进制或浮点数时，zui小整数位数设置范围为1到16；固定小数位数设置范围为0到6；
3）输入框的zui大值和zui小值限制的是输入，对于显示没有限制，即在输入框中输入变量值时，zui大zui小值有效，但显示变量值时，没有限制；
4）Pro软件定义的整数显示范围为：-2147483648~2147483647，如用户使用输入框显示的数据会超出此范围，请使用浮点数显示
（3）键盘属性页
键盘属性页可以组态输入时键盘类型、形态、位置等属性。包括三种键盘类型（如图4所示）：
图4 输入框键盘属性页
● 系统默认键盘：输入时弹出系统默认样式键盘，系统缺省键盘可以根据关联数据类型弹出对应形态的输入键盘。
● 当前窗口键盘：输入时输入框不弹出键盘，而是通过物理键盘或窗口中已经组态的键盘进行输入操作。
● 其他窗口键盘：弹出键盘是用户自定义的键盘窗口。“键盘窗口”指定用户自定义键盘所在的窗口位置； “自定义位置”指定键盘弹出的位置，若不勾选此选项，键盘位置将跟随系统设置或键盘窗口配置参数。
（4）安全属性页
安全属性是指输入框在系统运行中是否可操作，是由指定的表达式的值决定。
● 表达式：本项中可以输入一个表达式，用表达式的值来控制构件是否可操作（即使能状态）。如不设置任何表达式，则运行时，构件始终处于可操作状态。可使用右侧的问号（“？”）按钮查找并设置所需的表达式。
● 条件设置：本项指定表达式的值与构件使能状态相对应。
● 失效样式：指定构件不可操作时（构件失效）构件的外观状态。
图5 输入框安全属性页
3、昆仑通态触摸屏McgsPro软件动画构件构件方法
输入框构件支持的脚本操作函数，具体如下。
BeginInput()
函数意义： 弹出该构件输入软键盘（构件需有变量关联）。
返 回 值： 无
参 数： 无
实 例： 窗口0.控件0.BeginInput()
4、昆仑通态触摸屏McgsPro软件动画构件构件属性
Name、Left、Top、Width、Height、Focus、Visible 属性参考构件属性请参考（昆仑通态触摸屏McgsPro软件动画构件-公共属性）。。
Text
属性意义： 输入框中的显示文本。
属性类型： 字符型。
读写属性： 读写
注意事项： 写操作时，Text属性字符串会强转为关联的数据类型并对其赋值。
5、昆仑通态触摸屏McgsPro软件动画构件构件事件
Click、MouseDown、MouseUp、MouseMove、KeyDown、KeyUp 事件参考构件属性请参考（昆仑通态触摸屏McgsPro软件动画构件-公共属性）。。
Change
事件意义： 当输入框内容改变时触发。
注意事项： 只有通过键盘输入操作改变输入框内容才会触发
本文摘自：网络 2023-01-28
