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_T ag,Message_T ag,Number);

参数描述

Analog_T ag不带引号或常数的实际整型或实型标记名。

Message_T ag不带引号或常数的实际整型或实型标记名。

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 可以是字符常数或含有该配方名称的消息标记名。

实例

下面的语句将使为配方Recipe1 （在recfile.csv 文件中）定义的值加载到由Unit 定义的一组标记名中：

RecipeLoad("c:\recipe\recfile.csv", "Unit1", "Rec ipe1");

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() 函数返回此参数的值。没有引号或字符串文字的实际消息标记名。