OpenPicture 子程序 | iFX 6.5

语法

OpenPicture [Picture], [PictureAlias], [TopPosition], [LeftPosition], [intErrorMode], [CallingPicture], [TSPicType], [TagList], [bNewInstance]

属性

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

组成部分	描述
画面	字符串。（可选）。要打开的画面的文件名。如果未指定任何文件名，运行“打开”对话，使用户能够选择需要打开的画面。
PictureAlias	字符串。希望指派给画面的别名。
TopPosition	变量。（可选）希望将画面顶部放置到的位置。默认 = 0。
LeftPosition	变量。（可选）希望将画面左侧放置到的位置。默认 = 0。
intErrorMode	整数。（可选）。错误模式。 0（默认）– 允许子程序提供错误消息。以消息框的形式显示错误。如果未输入intErrorMode参数，则使用默认值。 1 – 允许用户处理错误信息。将子程序中的错误传回到调用例程以进行处理。 2 – 把错误写入所有目标。不显示错误消息，而是使用SendOperatorMessage将错误写入所有iFIX目标，包括“报警历史”窗口目标。
调用画面	对象。其标签状态功能将被访问的画面。
TSPicType	TS_PIC_TYPE (可选) 要打开的标签状态画面的类型: 0 – 单个标签TS画面 1 – 快速趋势 2 – 标签控制面板
TagList	变量。在标签状态画面中使用的一个字符串数组。
bNewInstance	布尔值。（可选）。说明画面是否是新实例。如果将该值设置为TRUE，则将打开同一画面的新实例。 True - 打开同一画面的一个新实例。 False – 不打开画面的新实例。这是默认设定。

备注

别名是用户定义的通用画面名称。通过使用别名，可以控制多个画面的打开和关闭，而不会影响当前显示的画面。

只有在未提供任何“画面”字符串、且未提供CallingPicture和TSPicType参数时，才可使用标签状态功能。如果未提供CallingPicture参数，调用OpenPicture时会被当作普通的OpenPicture请求。如果提供了CallingPicture参数，但未提供TSPicType参数，调用OpenPicture时产生一条错误消息。

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

在运行模式中，可以在画面的新实例中修改VBA脚本。不过，对画面实例中脚本的修改内容不会被保存。不允许修改运行模式的脚本。要修改主画面中的脚本，切换至编辑模式，然后在主画面（而不是实例）中编辑脚本。

示例

OpenPicture 子程序示例