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

这个动作被用来打开一个相对于指定部件定位的指定对话框。

目标属性

属性	值	描述
xsi:type	clientSystem.Action

方法属性

属性	数据类型或值	描述
xsi:type	clientSystem.Action.OpenDialogAtTarget
dialogId	DialogReference	要打开的对话框的ID。
mode (optional)	DialogMode	对话框的模式。如果没有指定模式，那么将使用 "无模式 "的值。
horizontalPos (optional)	•left •center •right	相对于引用的部件的水平位置。如果没有指定水平位置，那么将使用 "右 "值。
verticalPos (optional)	•top •middle •bottom	相对于引用的部件的垂直位置。如果没有指定垂直位置，那么将使用 "top "值。
target	String	要被引用的部件的标识符。该标识符由ContentId组成，后面是下划线和相应的WidgetId。例子。ContentId:Content1, WidgetId:Button1，有效的部件标识符。Content1_Button1。如果此参数使用了无效的widget标识符，相应的错误信息会被输入到记录器中。
headerText (optional)	String or localized text	将自定义的标题定义为字符串或文本ID。如果不使用此参数，则使用对话框中的显示名称。
autoClose (optional)	Boolean	通过在对话框外点击关闭对话框。如果此值被设置为 "true"，那么用户可以通过点击对话框旁边来关闭对话框。如果没有设置此值，则应用默认值 "false"。在这种情况下，用户只能通过点击关闭按钮来关闭对话框。
horizontalDialogAlignment (optional)	•left •center •right	对话框的水平排列。如果没有指定水平对齐方式，则使用 "左 "值。
verticalDialogAlignment (optional)	•top •middle •bottom	对话框的垂直对齐。如果没有指定垂直对齐方式，则使用 "顶部 "值。
autoRaise (optional)	AutoRaise	该参数可用于配置对话框的zIndex的自动调整。如果不使用该参数，则使用 "启用"。

行为

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

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

在一个事件处理程序中，可以用OpenDialogAtTarget的动作顺序一个接一个地打开多个对话框。OpenDialogAtTarget动作可以与CloseDialog、LoadContentInArea、LoadContentInDialogArea一起用于事件处理程序的顺序或平行动作中。

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

例子

Example 1:

Example 2:

Example 3: