EpSynall参考手册_库函数说明.docVIP

EpSynall的库函数 本章主旨： ( 讲解调用系统内部函数的方法 ( 内部函数使用说明 I.1调用内部函数的方法 第一步：在定义命令语言对话框中单击“内部函数”按键，弹出函数列表对话框。如图I.1.1所示： 图I.1.1选择函数 第二步：选择函数 在“函数名称列表”框中选择要使用的函数，并单击确定。弹出如图I.1.2所示的对话框： 图I.1.2设置函数参数 第三步：设置函数参数 在图I.1.2中的“函数输入变量类型”列表框中选中参数类型，并在“函数输入变量名”编辑框中输入变量或参数。所有参数设置完成后确定，设置完成。 ( 请尝试这样做：在‘函数列表’对话框中选择HideWindow函数并确定（如图I.1.1），然后在‘函数输入’对话框中设置函数参数”test”（即：窗口名）如图I.1.2所示并确定退出，此时你会看到如图I.1.3的画面。 图I.1.3 在后台语言中添加HideWindow函数 I.2内部函数的调用格式（按字母查询） EPSYNALL提供了许多复杂的内部函数，其中包括字符串函数、数学函数、系统函数、控件函数以及其它类型的函数。 下面介绍各函数的调用格式： ( 注：在示例中Dim表示在组态系统数据词典中定义的变量。 I.2.1字符串函数 1. ftostr 函数 此函数将一实数值转换成字符串形式。 语法：ftostr (Real,Number1,Number2) 参数描述： Real根据Number1和Number2转换成字符串形式，该参数可包含任何有效的数值表达式。 Number1指定Real值的位数，包括整数位数和小数位数，不含小数点。Number2指定Real值的小数位数，该参数为零时，输出的字符串中无小数部分。 返回值：该函数返回代表一数值的字符串，返回值为消息类型。 ( 示例： 本示例使用 ftostr 函数将一个实型变量转成字符串。 Dim MyString （消息类型）、Float （浮点型）、Int（整型） Float=612.58; Int=-72; MyString = ftostr(Float,5,3); 返回 612.580。 MyString = ftostr(Float,5,0); 返回 612。 MyString = ftostr(Int,2,0); 返回 -72。 2. FindSubStr 函数 此函数用于查找指定字符子串在字符串中的位置（位置从0开始）。 语法： FindSubStr (SourceStr,SearchStr) 参数描述： SourceStr用于查找SearchStr位置的字符串，若SourceStr中包含多个SearchStr子串，则返回其出现的第一个位置。 SearchStr指定要查找的字符子串。 返回值： 该函数返回字符子串在字符串中的第一个位置，返回值为整型。若返回值为-1则表示字符串中不包含被查找的子串。 ( 示例： 本示例使用FindSubStr函数查找子串在字符串中的位置(区分大小写）。 Dim SourceStr, SearchStr（消息类型） Dim NumResult（整型，取值范围-1~65535） 1) SourceStr=”windows drow”; SearchStr=”ow”; NumResult= FindSubStr(SourceStr,SearchStr); 返回4。 2) SourceStr=”windows”; SearchStr=”dos”; NumResult= FindSubStr(SourceStr,SearchStr); 返回-1。 3) SourceStr=”Windows”; SearchStr=”w”; NumResult= FindSubStr(SourceStr,SearchStr); 返回5。 4) SourceStr=”Windows”; SearchStr=”Win”; NumResult= FindSubStr(SourceStr,SearchStr); 返回0。 3. ltodate 函数 此函数将表示时间的整数转换为日期字符串。 语法：ltodate (nTime,nType) 参数描述： nTime表示时间的长整数，用户可通过全局变量“$时间值”获得表示当前时间的长整数值。 nType指定返回的日期字符串的格式。 0: 对应格式“****/**/**”(年/月/日); 1: 对应格式“**/**/****”(月/日/年); 2: 对应格式“****-**-**”(年-月-日); 3: 对应格式“**-**-****”(月-日-年); 4: 对应格式“****年%**月%**日” 注：有几个“*”就代表有几位数字。 返回值：