mappView帮助助手 > mapp View帮助信息 > 工程 > 事件和行动 > 行动 > Client actions

此操作打开一个指定的对话框。

目标属性

属性	值	描述
xsi:type	clientSystem.Action

Method attributes

属性	数据类型或值	描述
xsi:type	clientSystem.Action.OpenDialog
dialogId	DialogReference	要打开的对话框的ID
mode (optional)	DialogMode	对话框的模式。如果没有指定模式，则使用 "modal "值。
horizontalPos (optional)	•left •center •right •Absolute position: e.g. 10px	参考HMI应用程序的水平位置。如果没有指定水平位置，则使用 "中心 "值。
verticalPos (optional)	•top •middle •bottom •Absolute position: e.g. 10px	参照HMI应用的垂直位置。如果没有指定垂直位置，那么将使用 "中间 "值。
headerText (optional)	String or localized text	将自定义的标题定义为一个字符串或文本ID。如果不使用这个参数，则使用对话框中的显示名称。
autoClose (optional)	Boolean	通过在对话框外点击关闭对话框。如果此值被设置为 "true"，那么用户可以通过点击对话框旁边来关闭对话框。如果没有设置此值，则应用默认值 "false"。在这种情况下，用户只能通过点击关闭按钮来关闭对话框。
autoRaise (optional)	AutoRaise	该参数可用于配置对话框的zIndex的自动调整。如果不使用该参数，则使用 "启用"。

行为

执行这个动作可以打开指定的对话框。

如果对话框没有被定义，那么一个错误信息将被显示在一个消息框中。

在一个事件处理程序的动作序列中，可以通过OpenDialog一个接一个地打开几个对话框。OpenDialog动作可以与CloseDialog、LoadContentInArea、LoadContentInDialogArea一起用于一个事件处理程序的顺序或并行动作中。

这个动作不允许在带有Navigate动作的事件处理程序的平行动作中执行。不允许在动作OpenDialog（仅在事件DialogOpened或ContentLoaded）之后的序列中访问配置在对话框中的内容片的部件。如果同一个事件绑定被快速地一个接一个地调用（例如快速点击同一个按钮），有可能前一个事件绑定还没有被完全处理。这可能会导致动作的平行执行，例如，取消第二个导航动作。

例子

打开对话框 "dialog1"。对话框应该被放置在左上角。