InTouch-函数及语句简介

Intouch语句简介Intouch函数及语句介绍R1: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()函数，相应的错误代码可以被写到一个模拟标记名，并且关联的错误代码消息可以被写到一个消息标记名中。DataChangeScriptTagname[.field]:ErrorCodeScriptbody：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可以是字符常数或含有该配方名称的消息标记名。第页共531Intouch语句简介实例下面的语句将使为配方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()函数返回此参数的值。没有引号或字符串文字的实际消息标记名。第页共532Intouch语句简介Number如果一个函数需要字符参数，该域设置返回到参数的昀大字符串长度。在InTouch中，字符串消息标记名的昀大长度是131个字符。除非你减小了InTouch标记名的昀大字符串长度，此参数一般设为131。数字或整型标记名。实例下面的语句使系统读出RecipeName标记名的当前值且返回文件中的前一个配方。此返回的字符串将被储存在RecipeName中并覆盖当前值。若RecipeName的值为空白或不能找到，将返回文件的昀后一个配方。若RecipeName当前包含的是文件的第一个配方，则返回此配方。(配方按创建时的顺序保存。)RecipeSelectPreviousRecipe(c:\recipe\recfile.csv,RecipeName，131);7:RecipeSelectRecipe()选择当前在配方模板文件中定义的一个配方。句法RecipeSelectRecipe（“Filename”，“RecipeName”，“Number”）;参数描述FileName此函数所作用的配方模板文件的名称。实际消息标记名。RecipeName此函数使用的指定配方模板文件中指定的配方。RecipeLoad()、RecipeSave()和RecipeDelete()函数需用户提供RecipeName。RecipeSelectRecipe()函数返回此参数的值。没有引号或字符文字的实际消息标记名。Number如果一个函数必须填充字符参数，该域设置返回到参数的昀大字符串长度。在InTouch中，字符串消息标记名的昀大长度是131个字符除非你减小了InTouch标记名的昀大字符串长度，此参数一般设为131。数字或整型标记名。实例下面的语句打开“选择一个配方”对话框。RecipeSelectRecipe(c:\recipe\recfile.csv,RecipeName,131);当在对话框中选定一个配方后，它的名称返回到RecipeName标记名中。8:RecipeSelectUnit()选择将被加载当前配方值的标记名单元。句法RecipeSelectUnit（“Filename”，“UnitName”，“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。在未用自动更新网络应用程序开第页共533Intouch语句简介发（NAD）功能时，可以用此函数来更新应用程序。此函数可和“$ApplicationChanged”配合使用以判断何时发生NAD的更新，然后提供自定义关闭。但使用NAD选项，通知操作员,操作员可能必须延迟到较晚时间再更新，或者此函数可被放置在一个按钮动作脚本中，因此当方便的时候一个操作员可进行自动关闭和重新启动WindowViewer。10:Round()按指定精度来近似一个实数。句法RealResult=Round(Number,Precision);参数描述Number任何数字，实型或整型标记名。Precision设定数字将要被近似到的精度。数字，实型或整形标记名。说明“Precision”设置了“Number”将被近似的精度。实例Round(4.3,1)将返回4Round(4.3,.01)将返回4.30Round(4.5,1)将返回5Round(-4.5,1)将返回-5Round(106,5)将返回105Round(43.7,.5)将返回43.5AAbs()返回一个指定数的绝对值（无符号等价值）。句法Result=A