Intouch函数及语句介绍.doc

Intouch语句简介Intouch函数及语句介绍R1: RecipeDelete() 从指定配方模板文件中删除配方名。句法RecipeDelete（“Filename”,“RecipeName”）;参数描述FileName被函数所作用的配方模板文件。实际字符串或消息标记名。RecipeName在将被函数删除的指定配方模板文件中的特定配方。RecipeLoad()、RecipeSave() 和 RecipeDelete() 函数需用户提供 RecipeName 参数。RecipeSelectRecipe() 函数返回此参数的值。实际字符串或消息标记名。实例下面的语句将配方“Recipel”从 recfile.csv 文件中删除：RecipeDelete(c:reciperecfile.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:ErrorCodeScript body：RecipeGetMessage(ErrorCode, ErrorMessage,131);当模拟标记名 ErrorCode 的值发生变化时，将自动执行此脚本。当此脚本执行时，RecipeGetMessage() 函数将读取标记名 ErrorCode 的当前数字值，并且返回与此数字值关联的消息到标记名 ErrorMessage。ErrorCode = RecipeLoad (c:Apprecipe.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:reciperecfile.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:reciperecfile.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:reciperecfile.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:reciperecfile.csv, RecipeName，131);7: RecipeSelectRecipe() 选择当前在配方模板文件中定义的一个配方。句法RecipeSelectRecipe（“Filename”，“RecipeName”，“Number”）;参数描述FileName此函数所作用的配方模板文件的名称。实际消息标记名。RecipeName此函数使用的指定配方模板文件中指定的配方。RecipeLoad()、RecipeSave() 和 RecipeDelete() 函数需用户提供 RecipeName。RecipeSelectRecipe() 函数返回此参数的值。没有引号或字符文字的实际消息标记名。Number如果一个函数必须填充字符参数，该域设置返回到参数的最大字符串长度。在 InTouch 中，字符串消息标记名的最大长度是 131 个字符除非你减小了 InTouch 标记名的最大字符串长度，此参数一般设为 131。数字或整型标记名。实例下面的语句打开“选择一个配方”对话框。RecipeSelectRecipe(c:reciperecfile.csv, RecipeName , 131);当在对话框中选定一个配方后，它的名称返回到 RecipeName 标记名中。8: RecipeSelectUnit() 选择将被加载当前配方值的标记名单元。句法RecipeSelectUnit（“Filename”，“UnitName”，“Number”）;参数描述FileName此函数所作用的配方模板文件的名称。实际消息标记名。UnitName此函数使用的指定配方模板文件中指定的单元。RecipeLoad()函数需用户提供 UnitName。RecipeSelectUuit() 函数返回此参数的值。没有引号或字符文字的实际消息标记名。Number如果函数的参数需用字符串来填充，此参数设置返回到参数的最大字符串长度。在 InTouch 中，字符串（消息）标记名的最大长度可达 131 个字符。除非你减小了 InTouch 标记名的最大字符串长度，此参数一般设为 131。数字或整型标记名。实例下面的语句打开“选择一个单元”对话框。RecipeSelectUnit(c:reciperecfile.csv, UnitName, 131);一旦选定了某个单元，单元的名称将返回给 UnitName 标记名。注意RecipeSelectRecipe() 和 RecipeSelectUnit() 函数都与 RecipeLoad() 函数结合使用。 &有关连接函数更详尽的消息，请参看配方管理器用户指南中“组合配方函数”一节。9: RestartWindowViewer; 允许用户控制关闭和重启 WindowViewer。句法RestartWindowViewer;说明此函数将关闭然后自动重新启动 WindowViewer。在未用自动更新网络应用程序开发（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=Abs（Number）;参数描述数字任何数字，实型或整型标记名。说明“Number”的绝对值被计算并返回给“Result”。实例Abs(14) 将返回 14Abs(-7.5) 将返回 7.5Ack() 确认任何不确认的 InTouch 报警。 句法Ack Tagname；参数描述Tagname任何 InTouch 标记名，报警组，或组变量。说明此函数可用于一标记名、报警组或组变量。（组变量为一标记名，它具有分配给它的报警组名称。）实例以下语句可用于一按钮，来确认任一未确认的报警：Ack $System; （所有的报警）Ack Tagname；Ack GroupName;Ack GroupVariable;ActivateApp()激活另一个正在运行的 Windows 应用程序句法ActivateApp TaskName;参数描述TaskName这个函数将激活的任务。说明TaskName 是准确的文本字符串，包括出现在任务栏或任务管理器中的空格（在 Windows NT 中通过右单击任务栏，然后单击任务管理器或 Ctrl+Alt+Delete 来 访问）。实例以下例子检查是否命令 提示符正在运行。 如果正在运行，将使它出现在前景并给予聚焦。否则，启动一个命令提示符并启动命令提示符中的 DOS 程序 。 IF InfoAppActive( InfoAppTitle(cmd) = 1 THENActiveApp InfoAppTitle(cmd);ELSEStartApp cmd /c edit;ENDIF;almAckAll() 确认所有当前查询中的报警，包括那些在当前报警显示中未显示的报警。句法Result=almAckAll（ObjectName,Comment）;参数描述ObjectName报警对象的名称。如，AlmObj_1。Comment报警确认注释。实例MessageTag = “Acknowledge All by” + $Operator;AlmAckAll(揂lmObj_1? MessageTag);almAckDisplay() 只确认当前报警显示对象中可见的报警。句法Result=almAckDisplay（ObjectName,Comment）;参数描述ObjectName报警对象的名称。如，AlmObj_1。Comment报警确认注释。实例almAckDisplay（“AlmObj_1”, “Display Acknowledge”）;almAckRecent() 确认最近发生的报警 句法Result=almAckRecent（ObjectName,Comment）;参数描述ObjectName报警对象的名称。如，AlmObj_1。Comment报警确认注释。说明有关一个错误号列表，见附录 A。实例almAckRecent(“AlmObj_1”, $DateString);almAckSelect() 只确认报警显示中选定的报警。句法Result=almAckSelect（ObjectName,Comment）;参数描述ObjectName报警对象的名称。如，AlmObj_1。Comment报警确认注释。实例IF ($Hour 0 and $Hour 8000 THENalmSelectAll(“AlmObj_1”);almAckSelect(“AlmObj_1”, “Ack Selected by a Manager”);ENDIF;Text() 使消息类型标记名根据指定的 Format_Text 格式显示一个模拟(整型或实型)标记名的值。 句法MessageResult=Text(Analog_Tag,Format_Text);参数描述Analog_Tag要转换的数字，实型或整型标记名。Format_Text在转换中要使用的格式。实际字符串或消息标记名。实例MessageTag=Text(66,#.00);MessageTag 是一个消息类型标记名，66 为一个整型或实型的标记名。 “#0.00”代表显示格式：If Analog_Tag=66, then MessageTag=66.00.If Analog_Tag=22.269, then MessageTag=22.27.If Analog_Tag=9.999, then MessageTag=10.00.LogMessage(The current value of FreeserRoomTemp is:+ Text (FreezerRoomTemp, #.#);在下列例子中，消息标记将被设定为One=1 Two=2.MessageTag = One + + Text(1,#) + StringChar(32) + Two + + Text(2,#);SSelSPCConSampln1SDMsgDDE 类型消息访问RO描述“连续样本在一个标准偏差内”的报警消息标记。SendKeys发送键给应用程序。对接收应用程序来说，这些键就好象是从键盘上键入的。此项功能可用来给应用程序输入数据或给应用程序发送命令。大部分键盘上的键可以用在 SendKeys 语句中。每个键可用一个或多个字符表示，例如“A”表示字母“A”或ENTER表示回车键。句法SendKeys KeySequence;参数描述KeySequence任何键顺序或消息类型标记名。说明若要指定一个以上的键，则需将每个字符的代码连接起来。如，要指定一个后面跟着一个(b)的美元符号($)键，输入 b。下面列出了一个唯一键盘键的有效发送键：键代码键代码BACKSPACEBACKSPACE or BSHOMEHOMEBREAKBREAKINSERTINSERTCAPSLOCKCAPSLOCKLEFTLEFTDELETEDELETE or DELNUMLOCKNUMLOCKDOWNDOWNPAGE DOWNPGDNENDENDPAGE UPPGUPENTERENTER or (tilde)PRTSCPRTSCESCAPEESCAPE or ESCRIGHTRIGHTF1F1*TABTABUPUP* 所有功能键也可以以同样的方式输入。特殊字符 (SHIFT，CTRL 和 ALT)有它们自己的键码：键代码SHIFT+ (plus)CTRL (caret)ALT% (percent)SetPropertyD() 指定运行期间要写的属性的离散值。句法ErrorNumber字=SetPropertyD(ControlName.Property, DiscreteTag);参数描述ControlName窗口控制名称。如，ChkBox_1 或报警对象名。如，AlmObj_1。.Property窗口控制或报警对象属性。 DiscreteTag当该函数执行时，一个保存要写入值的离散值或离散标记名。典型用法：0 = 控制失效1 = 控制被激活SetPropertyI() 指定运行期间要写的属性的整型值。句法ErrorNumber字=SetPropertyI(ControlName.Property, Integer);参数描述ControlName窗口控制名称。如，ChkBox_1 或报警对象名。如，AlmObj_1。.Property窗口控制或报警对象属性。 Integer一个数字或整型标记名。SetPropertyM() 指定运行期间要写的属性的消息值。 句法ErrorNumber字=SetPropertyM(ControlName.Property, MessageTag);参数描述ControlName窗口控制名称。如，ChkBox_1 或报警对象名。如，AlmObj_1。.Property窗口控制或报警对象属性。 MessageTag被写给 ControlName 的属性的字符串。实际字符串或消息标记名。Sgn() 判别一个数值的符号（正、零或负） 句法RealResult=Sgn（Number）;参数描述Number任何数字，实型或整型标记名。说明若输入的数为正的，则结果为 1。负数将返回 -1，0 将返回 0。例子Sgn(425) 将返回 1Sgn(0) 返回 0Sgn(-37.3) 返回 1Show 显示指定的窗口。(窗口名称必须在引号内。)句法Show“Window”;参数描述Window被显示窗口的名称。实际字符串或消息标记名。说明“Window”必须和现存的窗口或要创建的窗口的名称相匹配。在运行期间，若窗口不存在，WindowViewer 将此语句忽略。若窗口的名称改变了，则它在脚本中必须改变。实例Show“Alarm Summary Window”；注意如果脚本仅仅在隐藏或显示窗口，我们建议使用“Show Window”或“Hide Window”链接被使用。若使用上述函数并且窗口名改变了，InTouch 将自动作出变化。ShowAt() 显示窗口时，指定其水平和垂直方向的像素位置。句法ShowAt（“Window”,Horiz,Vert）;参数描述Window窗口的名称。实际字符串或消息标记名。Horiz水平像素位置。数字或整型标记名。Vert垂直像素位置。数字或整型标记名。说明当窗口打开时，它将位于水平和垂直座标的中心。若它的边界超出了屏幕，那它就不会被居中。对那条边的最佳拟合将被执行。实例下面的语句中，100 代表水平像素的位置，200 代表垂直像素的位置：ShowAt(Window Name,100,200);模拟输入对象也能被创建并与内存标记名（如 TagHoriz 和 TagVert）相链接，以在运行期间动态地改变窗口的位置。在此情况下，语句应输入为：ShowAt(Boiler Room 7 Details,TagHoriz,TagVert);下面的语句判别对象的像素位置，内部标记名 $ObjHor 和 $ObjVer 可分配给用以显示当前选定对象的位置的模拟量输出链。通过使用链接到对象或按钮的脚本中的 $ObjHor 和 $ObjVer 标记名，可在此对象或按钮的顶端居中位置显示窗口。ShowAt(Window Name,$ObjHor,$ObjVer);ShowAt() 显示窗口时，指定其水平和垂直方向的像素位置。句法ShowAt（“Window”,Horiz,Vert）;参数描述Window窗口的名称。实际字符串或消息标记名。Horiz水平像素位置。数字或整型标记名。Vert垂直像素位置。数字或整型标记名。说明当窗口打开时，它将位于水平和垂直座标的中心。若它的边界超出了屏幕，那它就不会被居中。对那条边的最佳拟合将被执行。实例下面的语句中，100 代表水平像素的位置，200 代表垂直像素的位置：ShowAt(Window Name,100,200);模拟输入对象也能被创建并与内存标记名（如 TagHoriz 和 TagVert）相链接，以在运行期间动态地改变窗口的位置。在此情况下，语句应输入为：ShowAt(Boiler Room 7 Details,TagHoriz,TagVert);下面的语句判别对象的像素位置，内部标记名 $ObjHor 和 $ObjVer 可分配给用以显示当前选定对象的位置的模拟量输出链。通过使用链接到对象或按钮的脚本中的 $ObjHor 和 $ObjVer 标记名，可在此对象或按钮的顶端居中位置显示窗口。ShowAt(Window Name,$ObjHor,$ObjVer);ShowHome;显示“起始”窗口。起始窗口为那些你所选的，WindowViewer 启动时自动打开的窗口。（起始窗口可通过“WindowViewer 属性 - 起始窗口”属性页来选择。）句法ShowHome;Sin() 返回以度数表示的角的正弦值。句法Result=Sin(AngleNumber);参数描述AngleNumber以度为单位的角度。任何数字，实型或整型标记名。说明“Number”的正弦值被计算并返回到“Result”。实例Sin(90) 将返回 1Sin(0) 返回 0wave = 100 * sin (6 * $second);ShowTopLeftAt() 窗口显示时，指定其左上角的水平和垂直像素位置。句法ShowTopLeftAt(Window,Horiz,Vert);参数描述Window窗口的名称。实际字符串或消息标记名。Horiz水平像素位置。数字或整型标记名。Vert垂直像素位置。数字或整型标记名说明当窗口打开时，它的左上角将位于水平和垂直座标相交处。（屏幕的最左上角的像素位置是 0，0。）除了是控制要显示的窗口的左上角的位置外，此函数的工作原理与 ShowAt() 函数相同。WwcAddItem() 将提供的字符串加入到列表框或组合框。若列表框或组合框创建时未排序，则字符串添加到列表的末尾。否则字符串被插入到列表中，并且列表被排序。句法ErrorNumber=wcAddItem(ControlName,MessageTag);参数描述ControlName窗口控制对象的名称。如，ListBox_1。 实际字符串或消息标记名。MessageTag将被显示的消息字符串。实际字符串或消息标记名。应用于列表框和组合框实例当窗口（使用显示时窗口脚本）包含的列表框被打开时，下面的语句将消息字符串的内容添加到列表框中：wcAddItem(ListBox_1, Chocolate);wcAddItem(ListBox_1, Vanilla);wcAddItem(ListBox_1, Strawberry);wcClear() 删除列表框或组合框中的所有项。句法ErrorNumber=wcClear(ControlName);参数描述ControlName窗口控制对象的名称。如，ListBox_1。 实际字符串或消息标记名。应用于列表框和组合框实例当按下按钮（动作脚本），下面的语句将删除组合框中所有的项：wcClear(ListBox_1);wcDeleteItem() 删除列表框或组合框中与项索引参数关联的项。句法ErrorNumber=wcDeleteItem(ControlName,ItemIndex);参数描述ControlName窗口控制对象的名称。如，ListBox_1。 实际字符串或消息标记名。ItemIndex与该项目的位置对应的一个数字。数字或整型标记名。应用于列表框和组合框实例当按下按钮（动作脚本），下面的语句将删除一列表中的第三个项目：wcDeleteItem(ListBox_1, 3);wcDeleteSelection() 从列表中删除当前选定的项。句法ErrorNumber =wcDeleteSelection(ControlName);参数描述ControlName窗口控制对象的名称。如，ListBox_1。 实际字符串或消息标记名。应用于列表框和组合框实例当按下按钮（动作脚本）时，下面的语句将删除一个组合框列表中当前所选定的项：wcDeleteSelection(ListBox_1);wcErrorMessage() 返回一个描述该错误的消息字符串。句法ErrorMessage=wcErrorMessage(ErrorNumber);参数描述ErrorMessage消息标记名。ErrorNumber字被所有窗口控制函数返回的数字。数字或整型标记名。应用于列表框，文本框，组合框，复选框和单选按钮。实例若在加载列表时发生错误，则在消息标记名 ErrorDescription 中显示描述错误的文本。在此例中，一个字符串值输出动画链接被赋予标记名 ErrorDescription 来显示错误消息。显示时窗口脚本：ErrorNumber=wcLoadList(ListBox_1,c:InTouchrecipe.txt);ErrorDescription=wcErrorMessage(errorNumber);此函数也可以与各种窗口控制函数使用来显示错误消息：ErrorNumber=wcAddItem(ListBox_1,Wang Yong);ErrorMsg=wcErrorMessage(ErrorNumber);wcFindItem() 决定列表框或组合框中与消息字符串匹配的第一个项所对应的索引。句法ErrorNumber=wcFindItem (ControlName,MessageTag,DiscreteTag,Tagname);参数描述ControlName窗口控制对象的名称。如，ListBox_1。 实际字符串或消息标记名。MessageTag将被比较的消息字符串。实际字符串或消息标记名。DiscreteTag决定字符串比较的类型。可赋予下列离散值之一：0 = 大小写不敏感1 = 大小写敏感Tagname实际整型标记名名称。应用于列表框和组合框wcGetItem() 返回在列表框或组合框中与对应的 ItemIndex 相关联的项目字符串的值的属性。句法ErrorNumber=wcGetItem(ControlName,ItemIndex,Tagname);参数描述ControlName窗口控制对象的名称。如，ListBox_1。实际字符串或消息标记名。ItemIndex与该项目的位置对应的一个数字。数字或整型标记名。Tagname实际实型或整型标记名名称。wcGetItem 函数将与项目相应的数值放入从该函数返回的标记名。应用于列表框和组合框实例当按下按钮（动作脚本）时，下面的语句将把一个组合框中第10个项目的字符串值返回给消息标记名 ListSelection：wcGetItem(combobox_1, 10, ListSelection);若列表中的第10项是“Vanilla”，则 ListSelection 将包含字符串“Vanilla”。wcGetItemData() 决定由参数 ItemIndex 识别的列表项相关的整型值。句法ErrorNumber=wcGetItemData(ControlName,ItemIndex,Tagname);参数描述ControlName窗口控制对象的名称。如，ListBox_1。 实际字符串或消息标记名。ItemIndex与该项目的位置对应的一个数字。数字或整型标记名。Tagname实际实型或整型标记名名称。wcGetItemData 函数将与项目相应的数值放入从该函数返回的标记名。 应用于列表框和组合框实例当按下按钮（动作脚本）时，下面的语句检索与列表框中第5个项相关的数字值，并将其返回给标记名 ItemValue：wcGetItemData(ListBox_1, 5, ItemValue);若列表中的第5个项目被赋予整型值 4500，则标记名 ItemValue 将包含 4500。wcInsertItem() 将 Message 字符串插入列表中。ItemIndex 是要插入的列表索引位置。与 wcAddItem() 不同，wcInsertItem() 函数将不对列表进行排序，即使它是一个有序列表框或组合框。句法ErrorNumber=wcInsertItem(ControlName,ItemIndex,MessageTag);参数描述ControlName窗口控制对象的名称。如，ListBox_1。 实际字符串或消息标记名。ItemIndex对应于被添加项位置的数字。若此参数为-1，则字符串将被添加到列表末尾。数字或整型标记名。MessageTag包含要在被 ItemIndex 所指示位置插入的字符串。.实际字符串或消息标记名。应用于列表框和组合框例实当按下按钮（动作脚本）时，下面的语句将一名为“Blueberry”的新项目插入到列表框从上到下第 4 个位置处。wcInsertItem(ListBox_1, 4, Blueberry);wcLoadList() 用包含于 FileName 的项目来替换列表框或组合框的内容。句法ErrorNumber=wcLoadList(ControlName,Filename);参数描述ControlName窗口控制对象的名称。如，ListBox_1。 实际字符串或消息标记名。Filename包含纯 ASCII 格式的文件名称。如果没有提供完整的路径名作为消息参数，则此函数将在应用程序目录查找消息文件。实际字符串或消息标记名。应用于列表框和组合框实例当包含组合框的窗口 （显示时窗口脚本） 被打开时，下面的语句加载一个正确格式的列表 (位于 C：InTouchrecipe.txt”) 到此组合框中：wcLoadList(Combobox_1, c:InTouch.32wclist.txt);wcLoadText() 以 FileName 的内容替换文本框的内容。句法ErrorNumber=wcLoadText(ControlName, Filename);参数描述ControlName窗口控制对象的名称。如，ListBox_1。 实际字符串或消息标记名。Filename包含纯 ASCII 格式的文件名称。如果没有提供完整的路径名作为消息参数，则此函数将在应用程序目录查找消息文件。实际字符串或消息标记名。说明wcLoadText() 函数只支持纯 ASCII 文本格式文件，诸如那些用 Microsoft 记事本程序创建的文件。窗口控制的错误号列在附录 A 中。&有关高级文件浏览能力，参见 Factory Suite 的“生产率包”的文档浏览器。应用于文本框实例当包含文本框的窗口 （显示时窗口脚本） 打开时，下面的语句加载一个记事本文本文件 (c:InTouchreadme.txt”) 到一个文本框中：wcLoadText(Textbox_1, c:InTouchreadme.txt);wcSaveList() 以列表框或组合框对象中所列项目替换 FileName 的内容。句法ErrorNumber=wcSaveList(ControlName,Filename);参数描述ControlName窗口控制对象的名称。如，ListBox_1。 实际字符串或消息标记名。Filename包含纯 ASCII 形式的文件名称。如果文件不存在，则将被创建。使用 wcLoadList() 函数，这些项目能被相继加载到列表对象中。实际字符串或消息标记名。应用于列表框和组合框实例当按下按钮（动作脚本）时，下面的语句将当前列表框中的项存到一文件中 (c:InTouchnewList.txt”)：wcSaveList(ListBox_1, c:InTouchnewlist.txt);注意如果外部 ASCII 文件被用来填充列表框和组合框，则它们必须遵照特定的格式并且包含特定的消息。格式如下所示：ControlType, ListCountListItem, ItemDataListItem, ItemDataListItem, ItemData例如：一个要被加载到一个组合框中的列表文件，它包含三个供选择的项，并且这些项没有被赋予项数据。（有关项数据的更多信息，参见 wcSetItemData() 函数）。文件的格式如下所示：ComboBOX, 3ComboBOX, 3Vanilla, 0Strawberry, 0描述：COMBOBOX 是控制类型。Chocolate,Vanilla,和 Starwberry 的 ListCount 为 3 ，代表其三个项目。Chocolate 则被列为第一个列表项目或索引1。Vanilla 作为索引2，而最后 Strawberry 作为 3。每一个索引项目都有一个 0 数据值。wcSaveText() 将包含于文本框中的文本保存到 FileName。如果此文件不存在，它将被创建；如果它存在，则其必须是可读/写的。句法ErrorNumber=wcSaveText(ControlName,Filename);参数描述ControlName窗口控制对象的名称。如，ListBox_1。 实际字符串或消息标记名。Filename包含纯 ASCII 格式的文件的名称。如果没有提供完整的路径名，则此函数将保存在应用程序目录下。如果文件不存在，则将被创建。使用 wcLoadList() 函数，这些项目能相继被加载到列表对象中。实际字符串