ReplacePicture 子程序

关闭画面 并用另一个画面替换。如果已经在工作台中打开具有指定标签组文件的画面，则会在工作台中打开具有相同标签组文件的该画面的另一实例。打开的画面将拉伸或扭曲以使文档适应所替换画面的高度和宽度。DisableAutoScale 设置不会影响此行为。

句法

ReplacePicture NewPicture, [OldPicture], [TagGroupFileName], [intErrorMode], [bShowPictureNotOpenErrors];[CallingPicture];[TSPicType];[TagList];[bNewInstance]

属性

ReplacePicture子程序语法有这些部分:

组成部分	描述
NewPicture	字符串。要打开的画面的文件名。
OldPicture	字符串。（可选）。要替换的画面的文件名。如果没有指定任何画面，则替换当前活动的画面。
TagGroupFileName	字符串。希望随新画面载入的标签组文件的文件名。
intErrorMode	整数。（可选）。错误模式。 0（默认）– 允许子程序提供错误消息。以消息框的形式显示错误。如果未输入intErrorMode参数，则使用默认值。 1 – 允许用户处理错误信息。将子程序中的错误传回到调用例程以进行处理。 2 – 把错误写入所有目标。不显示错误消息，而是使用SendOperatorMessage将错误写入所有iFIX目标，包括“报警历史”窗口目标。
bShowPictureNotOpenErrors	布尔值。（可选）。如果这个值被设为TRUE，当需要替换的画面没有打开时会显示一个错误，并且不发生任何替换。备注
CallingPicture	对象。其标签状态功能将被访问的画面。
TSPicType	TS_PIC_TYPE (可选) 要打开的标签状态画面的类型: 0 – 单个标签状态画面 1 – 快速趋势画面 2 – 标签控制面板画面
TagList	变量。在标签状态画面中使用的一个字符串数组。
bNewInstance	布尔值。（可选）。说明画面是否是新实例。这个字段被用于打开多个画面。如果将该值设置为TRUE，则将打开同一画面的新实例。如果将该值设置为FALSE，则不会打开画面的新实例。备注

备注

只有在未提供任何“NewPicture”字符串、且未提供CallingPicture和TSPicType参数时，才可使用标签状态功能。如果未提供 CallingPicture参数，调用ReplacePicture时会被当作无效的ReplacePicture请求。如果提供了CallingPicture参数，但未提供TSPicType参数，调用ReplacePicture时会被当作无效的ReplacePicture请求。

如果已经通过NewPicture参数提供了一个字符串，则调用标准的ReplacePicture功能。在这种情况下，忽略CallingPicture、TSPicType和TagList参数。

如有可能，必须在脚本最后一行调用。注意，在使用ReplacePicture 子程序、且被替换的文档是包含脚本的文档时，调用必须是脚本中的最后一行。否则，可能会在执行脚本时遇到意外情况。

如果ReplacePicture子程序不在被替换的画面中、且该子程序不是脚本中的最后一行，在继续执行脚本的其余部分之间应保证操作完成。

示例