LoadDisplay 方法

加载指定画面并返回表示曾加载画面的 Display 对象。
此方法相当于使用
/Z
参数发出
Display
命令(即缓存画面)。将
Visible
属性设置为 True 之前,画面不可见(即仍处于缓存状态)。此外,画面将不会以动画形式呈现(更新)。
调用此方法后,将以此顺序发生以下事件:
  • Application_DisplayLoad
  • Display_Load
语法
Application
.
LoadDisplay
Name
, [
Options
]
Set
oDisplay = Application.LoadDisplay(Name,
[
Options
])
其中
oDisplay
– 是 Display 对象变量的名称。
Application
– 是
FactoryTalk View SE
Client 应用程序对象的名称或对
FactoryTalk View SE
Client 应用程序对象求值的表达式。
Name
– 指定画面名称的字符串。在分布式应用程序中,该名称可以是完全限定名称。如果不是,将使用 Current Area 来解析画面名称。
Options
– 是可选字符串,包含可用于 Display 命令的任何命令行参数。由于本方法主要用于缓存画面,因此会忽略 /Z 和 /ZA 参数。
备注
  • 如果找不到按 Name 指定的画面,则会产生 Err.Number 等于 gfxErrorDisplayNotFound 的错误。
  • 如果已经加载具有指定名称的画面并且允许运行多个副本,则会加载并返回画面的一个新实例。如果不允许运行多个副本,则会返回先前加载的画面。
  • 如果当前用户没有访问画面或 Display 命令所需的安全码,则不会加载画面,并产生 Err.Number 等于 gfxErrorSecurityAccess 的错误。
  • 如果画面未呈现为动画形式,则 ActiveX 控件不会被激活,因此它们之间的交互可能会受到限制。
  • 在图形画面编辑器中测试画面中的动画时,调用此方法将引发 Err.Number 等于 gfxErrorTestAnimation 的错误。
提供反馈
对本文档有问题或反馈吗? 请在这里提交您的反馈
Normal