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 可以是字符常数或含有该配方名称的消息标记名。
实例
下面的语句将使为配方 Recipe1 （在 recfile.csv 文件中）定义的值加载到由 Unit 定义的一组标记名中：
getsavefilenameRecipeLoad("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() 函数返回此参数的值。没有引号或字符串文字的实际消息标记名。
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() 函数返回此参数的值。没有引号或字符文字的实际消息标记名。

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。