InTouch 函数及语句简介

第页 1 共 53
Intouch 语句简介
实例 下面的语句将使为配方 Recipe1 （在 recfile.csv 文件中）定义的值加载到由 Unit 定义 的一组标记名中： RecipeLoad("c:\recipe\recfile.csv", "Unit1", "Recipe1"); 4: RecipeSave() 将最新创建的配方或现有配方的更改保存到指定的配方模板文件。 句法 RecipeSave（“Filename”,“UnitName”,“RecipeName”）; 参数 描述 FileName 此函数所作用的配方模板文件的名称。FileName 可以是字符串常数或含有配 方模板文件的消息标记名。 UnitName 此函数使用的指定配方模板文件中指定的单元。RecipeLoad()函数需用户 提供 UnitName。RecipeSelectUuit() 函数返回此参数的值。UnitName 可以是字符常数 或含有该单元名称的消息标记名。 RecipeName 此函数使用的指定配方模板文件中指定的配方。RecipeLoad()，RecipeSave() 和 RecipeDelete() 函数需用户提供 RecipeName。RecipeSelectRecipe() 函数返回此参数 的值。配方名可以是字符常数或含有该配方名称的消息标记名。 实例 下列例子将保存对 recfile.csv 文件中的配方“Recipe3”的改变。如果 Recipe3 在 recfile.csv 文件中不存在，它将会被生成。数值将用于设定定义在 Unit2 中的标记名的 值。 RecipeSave("c:\recipe\recfile.csv", "Unit2", "Recipe3"); 5: RecipeSelectNextRecipe() 选择当前定义在配方模板文件中的下一个配方。 句法 RecipeSelectNextRecipe（“Filename”,“RecipeName”,“Number”）; 参数 描述 FileName 此函数所作用的配方模板文件的名称。实际消息标记名。 RecipeName 此函数使用的指定配方模板文件中指定的配方。RecipeLoad()、RecipeSave() 和 RecipeDelete() 函数需用户提供 RecipeName。RecipeSelectRecipe() 函数返回此参数 的值。没有引号或字符串文字的实际消息标记名。 Number 如果某一函数需要字符为参数，该域设置返回该参数的最大字符串长度。在 InTouch 中，字符串（消息）标记名的最大长度可达 131 个字符。除非你减小了 InTouch 标记 名的最大字符串长度。数或整型标记名，此参数一般设为 131。 实例 下面的语句使系统读出 RecipeName 标记名的当前值前且返回文件中的下一个配方。若 RecipeName 的值为空或不能找到，将返回文件的第一个配方。若 RecipeName 包含的是文件的最后 一个配方，则返此配方。（配方按创建时的顺序保存。） RecipeSelectNextRecipe("c:\recipe\recfile.csv", RecipeName, 131); 6: RecipeSelectPreviousRecipe() 选择当前配方模板文件中定义的前一个配方。 句法 RecipeSelectPreviousRecipe（“Filename”，“RecipeName”，“Number”）; 参数 描述 FileName 此函数所作用的配方模板文件的名称。实际消息标记名。 RecipeName 此函数使用的指定配方模板文件中指定的配方。RecipeLoad()、RecipeSave() 和 RecipeDelete() 函数需用户提供 RecipeName。RecipeSelectRecipe() 函数返回此参数 的值。没有引号或字符串文字的实际消息标记名。
RecipeSelectRecipe("c:\recipe\recfile.csv", RecipeName , 131); 当在对话框中选定一个配方后，它的名称返回到 RecipeName 标记名中。 8: RecipeSelectUnit() 选择将被加载当前配方值的标记名单元。 句法 RecipeSelectUnit（“Filename”，“tName”，“Number”）; 参数 描述 FileName 此函数所作用的配方模板文件的名称。实际消息标记名。 UnitName 此函数使用的指定配方模板文件中指定的单元。RecipeLoad()函数需用户 提供 UnitName。RecipeSelectUuit() 函数返回此参数的值。没有引号或字符文字的实际 消息标记名。 Number 如果函数的参数需用字符串来填充，此参数设置返回到参数的最大字符串长 度。在 InTouch 中，字符串（消息）标记名的最大长度可达 131 个字符。除非你减小 了 InTouch 标记名的最大字符串长度，此参数一般设为 131。数字或整型标记名。 实例 下面的语句打开“选择一个单元”对话框。
RecipeSelectUnit("c:\recipe\recfile.csv", UnitName, 131); 一旦选定了某个单元，单元的名称将返回给 UnitName 标记名。 注意 RecipeSelectRecipe() 和 RecipeSelectUnit() 函数都与 RecipeLoad() 函数结合使用。 & 有关连接函数更详尽的消息，请参看配方管理器用户指南中“组合配方函数”一节。 9: RestartWindowViewer; 允许用户控制关闭和重启 WindowViewer。 句法 RestartWindowViewer; 说明 此函数将关闭然后自动重新启动 WindowViewer。在未用自动更新网络应用程序开
第页 3 共 53
Intouch 语句简介
发（NAD）功能时，可以用此函数来更新应用程序。此函数可和“$ApplicationChanged” 配合使用以判断何时发生 NAD 的更新，然后提供自定义关闭。但使用 NAD 选项，通 知操作员,操作员可能必须延迟到较晚时间再更新，或者此函数可被放置在一个按钮动作 脚本中，因此当方便的时候一个操作员可进行自动关闭和重新启动 WindowViewer。 10: Round() 按指定精度来近似一个实数。 句法 RealResult=Round(Number,Precision); 参数 描述 Number 任何数字，实型或整型标记名。 Precision 设定数字将要被近似到的精度。数字，实型或整形标记名。 说明 “Precision”设置了“Number”将被近似的精度。 实例 Round(4.3, 1) 将返回 4 Round(4.3, .01) 将返回 4.30 Round(4.5, 1) 将返回 5 Round(-4.5, 1) 将返回 -5 Round(106, 5) 将返回 105 Round(43.7, .5) 将返回 43.5 A Abs() 返回一个指定数的绝对值（无符号等价值）。 句法 Result=Abs（Number）; 参数 描述 数字 任何数字，实型或整型标记名。 说明 “Number”的绝对值被计算并返回给“Result”。 实例 Abs(14) 将返回 14 Abs(-7.5) 将返回 7.5 Ack() 确认任何不确认的 InTouch 报警。
Intouch 语句简介
Intouch 函数及语句介绍
R 1: RecipeDelete() 从指定配方模板文件中删除配方名。 句法 RecipeDelete（“Filename”,“RecipeName”）; 参数 描述
FileName 被函数所作用的配方模板文件。实际字符串或消息标记名。 RecipeName 在将被函数删除的指定配方模板文件中的特定配方。RecipeLoad()、 RecipeSave() 和 RecipeDelete() 函 数 需 用 户 提 供 RecipeName 参 数 。 RecipeSelectRecipe() 函数返回此参数的值。实际字符串或消息标记名。 实例 下面的语句将配方“Recipel”从 recfile.csv 文件中删除： RecipeDelete("c:\recipe\recfile.csv", "Recipe1"); 2: RecipeGetMessage() 写给模拟标记名某一错误代码同时写给消息标记名相应的错误代 码消息。 句法 RecipeGetMessage(Analog_Tag,Message_Tag,Number); 参数 描述 Analog_Tag 不带引号或常数的实际整型或实型标记名。 Message_Tag 不带引号或常数的实际整型或实型标记名。 Number 该参数设置返回给 Message_Tag 的最大字符串长度。InTouch,消息标记名有 131 字符的最大长度。除非你减小在 InTouch 标记名称典中的 Message_Tag 的最大字 符串长度，该参数值为 131。该参数可以是常数或包含一个数值的整型标记名。 实例 在“InTouch 数据更改脚本”中使用 RecipeGetMessage() 函数，相应的错误代码可以被 写到一个模拟标记名，并且关联的错误代码消息可以被写到一个消息标记名中。 Data Change Script Tagname[.field]:ErrorCode Script body：RecipeGetMessage(ErrorCode, ErrorMessage,131); 当模拟标记名 ErrorCode 的值发生变化时，将自动执行此脚本。当此脚本执行时， RecipeGetMessage() 函数将读取标记名 ErrorCode 的当前数字值，并且返回与此数字值关联的消息到标记名 ErrorMessage。 ErrorCode = RecipeLoad ("c:\App\recipe.csv","Unit1","cookies"); RecipeGetMessage(ErrorCode, ErrorMessage, 131); 3: RecipeLoad() 将指定的配方加载到指定的标记名单元中。 句法 RecipeLoad（“Filename”,“UnitName”,“RecipeName”）; 参数 描述 Filename 此函数所作用的配方模板文件的名称。FileName 可以是字符串常数或含有配 方模板文件的消息标记名。 UnitName 此函数使用的指定配方模板文件中指定的单元。RecipeLoad()函数需用户 提供 UnitName。RecipeSelectUuit() 函数返回此参数的值。UnitName 可以是字符常数 或含有该单元名称的消息标记名。 RecipeName 此函数使用的指定配方模板文件中指定的配方。RecipeLoad()、RecipeSave() 和 RecipeDelete() 函数需用户提供 RecipeName。RecipeSelectRecipe() 函数返回此参数 的值。RecipeName 可以是字符常数或含有该配方名称的消息标记名。