面板 - 对话框

显示模态或非模态对话框。对话框内容是底层窗口和文档的组成部分。

属性视图和全部属性视图

组件的“属性”视图显示可以对组件设置的最常见属性集,并且根据组件的不同,您还可以看到用于添加控件、操作或其他组件的选项。要打开“属性”视图,请单击窗口 > 显示视图 > 属性

“面板 - 对话框”组件的这些常用属性显示在“属性”视图的 hx:panelDialog显示选项选项卡上。请参阅下表以获取属性列表。

“全部属性”视图显示可以对组件设置的全部属性的表,包含可以从“属性”视图访问的那些属性。要切换至“全部属性”视图,请单击“属性”视图右上角的全部属性图标 “全部属性”图标

表 1. 面板 - 对话框属性

属性名称

描述

align

指定组件的对齐方式:
  • 向左对齐
  • 居中对齐
  • 向右对齐
  • 相对对齐

enableMoveKey

如果省略或为 true,则在可移动对话框中的某一项具有焦点时,可以通过在键盘上按下 Ctrl+Shift+箭头键来移动该对话框。如果为 false,则不能通过键盘来移动可移动对话框。

for

指定辅助控件组件要应用于的组件。该值应是所辅助的组件的 ID。

initialFocus

如果提供了 ID,则将显示对话框,开始时焦点将设置在此字段中,必要时选择字段的内容。如果省略或为 false,则将显示对话框,焦点将设置在对话框中第一个可以获得焦点的字段中。

initiallyShow

如果为 true,则当装入页面时,将显示对话框,调用 onshow 处理程序,禁用主窗口。如果为 false,则开始时不显示该对话框。

movable

指定是否可以通过在标题栏上按鼠标光标并将对话框拖到不同位置,或使用键盘等效键将对话框拖到不同位置,来移动对话框。如果为 false,则不能移动对话框。
注: 如果对话框可移动,但没有标题栏,则它只能使用键盘加速键来移动。

onhide

不显示对话框时要运行的 JavaScript™ 函数。此函数的特征符是 function(thisObj, thisEvent),其中 thisObj 指向对话框,而 thisEvent 是触发隐藏的事件。如果因为单击对话框中的“确定”或“取消”按钮(或等效于“取消”按钮的“关闭”按钮)而隐藏了对话框,则 thisEvent.dialogAction 的值将根据被单击的按钮而为 确定取消

onshow

显示对话框时要运行的 JavaScript 函数。此函数的特征符是 function(thisObj, thisEvent),其中 thisObj 指向对话框,而 thisEvent 是触发显示的事件。

relativeTo

如果提供了 ID,并且 align 或 valign 已设置为“相对对齐”,则将根据所标识的标记进行对齐。

saveState

如果为 true,则当对话框显示时,将对对话框中所有“表单”字段内的值进行备份,例如,保存输入和文本区域的值。为对话框编写的事件处理程序可以按程序方式获得已保存的值,而且在单击“取消”后,将使用这些值来恢复值的状态。如果为 false,则不保存值,而且在单击“取消”后,不会将值恢复为它们在对话框首次显示时的状态。

showTitleBar

如果为 true 或省略,则将在对话框顶部显示标题栏。如果为 false,则不会显示标题栏。

showTitleCloseButton

如果为 true 或省略,则将在标题栏(如果显示)中显示“关闭”按钮。如果为 false,则不会显示“关闭”按钮。
注: 单击“关闭”按钮和单击“取消”按钮一样。

title

指定标题文本,它在运行时以工具提示的形式显示在浏览器中。如果未指定备用文本,则浏览器将使用标题文本作为组件的备用文本。

titleCloseButtonImage

要用作“关闭”按钮的图像的 URL。(也可以通过 CSS 指定。)

类型

对话框的类型。模态对话框阻止使用键盘或鼠标在对话框下面的窗口中进行输入,必须填充该对话框并单击“确定”或“取消”,然后才能在页面中执行任何其他操作。非模态对话框:不是以块方式在对话框“下面”的窗口中输入。
注: 一次可能可以显示多个非模态对话框。如果同时显示了多个模态对话框,则这些对话框将叠放,只有最前面的对话框才是活动的。

valign

指定单元格中数据的垂直位置:
  • 顶部对齐
  • 中间对齐
  • 底部对齐
  • 相对对齐

反馈