ShowDisplay 方法
对指定画面执行加载、添加动画、可视化和赋予焦点操作。返回表示所显示画面的 Display 对象。
此方法与发送
Display
命令的作用相当。调用此方法后,将以此顺序发生以下事件:- Application_DisplayLoad
- Display_Load
- Display_AnimationStart
- Display_Activate
语法
Application
.ShowDisplay
Name
, [Options
]或
Set
oDisplay = Application
.ShowDisplay
(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 的错误。
- 在图形画面编辑器中测试画面中的动画时,调用此方法将引发 Err.Number 等于 gfxErrorTestAnimation 的错误。
提供反馈