UnloadDisplay 方法
卸载指定画面。如果缓存了画面,则会将其从缓存中移除。
如果使用
Unload
方法时不附带参数,则将卸载所有显示。调用此方法后,将以指示顺序发生以下事件:
- 如果画面处于活动状态:Display_Deactivate
- 如果正在播放画面动画:Display_BeforeAnimationStop
- Display_Unload
- 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 的错误。
提供反馈