UnloadDisplay 方法

卸载指定画面。如果缓存了画面,则会将其从缓存中移除。
如果使用
Unload
方法时不附带参数,则将卸载所有显示。
调用此方法后,将以指示顺序发生以下事件:
  1. 如果画面处于活动状态:Display_Deactivate
  2. 如果正在播放画面动画:Display_BeforeAnimationStop
  3. Display_Unload
  4. Application_DisplayUnload
语法
Application
.
UnloadDisplay
[
Name
], [
AllInstances
]
其中
Application
– 是
FactoryTalk View SE
Client 应用程序对象的名称或对
FactoryTalk View SE
Client 应用程序对象求值的表达式。
Name
– 指定画面名称的字符串。在分布式应用程序中,该名称可以是完全限定名称。如果不是,将使用 Current Area 来解析画面名称。
AllInstances
– 是一个可选的布尔型参数,如果为 True,则加载了多个实例时,将卸载通过 Name 指定的所有画面实例。AllInstances 的默认值为 True。
备注
  • 如果找不到指定名称的画面,不会发生错误。
  • 卸载画面前不会执行任何安全检查。
  • 如果对画面进行了多次引用(例如,由另一个对象变量引用),仍将卸载该画面,此后对已卸载的画面进行访问将导致错误。
  • 如果正在通过 PrintDisplay 命令打印该画面,则在完成打印之前不会将其卸载,但是该画面将不可见。
  • 在图形画面编辑器中测试画面中的动画时,调用此方法将引发 Err.Number 等于 gfxErrorTestAnimation 的错误。
提供反馈
对本文档有问题或反馈吗? 请在这里提交您的反馈
Normal