UI2.ShowModalDialog(String, Object, Object, Object, Object, Object) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在 Microsoft Office InfoPath 窗体中显示自定义模式对话框。
public object ShowModalDialog (string bstrName, object varArguments, object varHeight, object varWidth, object varTop, object varLeft);abstract member ShowModalDialog : string * obj * obj * obj * obj * obj -> objPublic Function ShowModalDialog (bstrName As String, Optional varArguments As Object, Optional varHeight As Object, Optional varWidth As Object, Optional varTop As Object, Optional varLeft As Object) As Object参数
- bstrName
- String
用于模式对话框的 .html 文件的名称。
- varArguments
- Object
指定显示模式对话框时要使用的参数。 可以是任何类型的值，包括数组值。
- varHeight
- Object
设置模式对话框的高度。
- varWidth
- Object
设置模式对话框的宽度。
- varTop
- Object
设置模式对话框的顶部相对于桌面左上角的位置。
- varLeft
- Object
设置模式对话框的左侧相对于桌面左上角的位置。
返回
一个用来指定如何显示模式对话框的 object。
实现
示例
在以下示例中，对象的 ShowModalDialog 方法 UIObject 用于显示自定义对话框。 请注意，对象 XDocument 使用 varArguments 参数传递到自定义对话框。
thisXDocument.UI.<span class="label">ShowModalDialog</span>("show.htm",(object)thisXDocument,100,100,10,10);
以下示例是用于实现简单自定义对话框的 HTML 代码。 请注意，使用 DHTML 窗口对象的 dialogArguments 属性从 ShowModalDialog 方法获取传递到自定义对话框的值，在本例中为 InfoPath 对象模型的 XDocument 对象。 当用户单击自定义对话框中的“显示警报”按钮时，窗体的基础 XML 文档的源 XML 将显示在消息框中。
<html>
<head>
<script language="jscript">
var gobjXDocument = null;
function Initialize()
{
// Save a reference to the XDocument object.
if (typeof window.dialogArguments == "object")
gobjXDocument = window.dialogArguments;
}
</script>
<title>A Simple Custom Dialog Box</title>
</head>
<body style="BACKGROUND-COLOR: window" onLoad="Initialize()">
<strong>Click one of the following buttons:</strong>
<br/>
<br/>
<div id="divButtons" tyle="align:center">
<input id="btnShowAlert" style="WIDTH: 106px; HEIGHT: 24px"
onclick='gobjXDocument.UI.Alert(gobjXDocument.DOM.xml);'
type="button" size="21" value="Show Alert"></input>
<input id="btnCancel" style="WIDTH: 106px; HEIGHT: 24px"
onclick="window.close();" type="button" size="21"
value="Cancel"></input>
</div>
</body>
</html>
有关如何使用 ShowModalDialog 框方法的信息，请参阅如何：显示警报和对话框。
注解
使用 ShowModalDialog 方法，可以在用户填写完全受信任的表单时向用户显示自定义对话框。 自定义对话框实现为在任何类型的 HTML 编辑器（如 Microsoft FrontPage）中创建的.html文件。 如果使用 参数将对象传递给自定义对话框，则可以在与 InfoPath 对象模型交互的自定义对话框中使用 varArguments 脚本代码。
若要在 InfoPath 窗体中使用自定义对话框，必须先使用“资源文件”对话框将自定义对话框的 .html 文件添加到窗体的资源文件集。 设计模式下的“工具”菜单中提供了“资源文件”对话框。 将自定义对话框文件添加到窗体后，可以使用 ShowModalDialog 方法显示它。
尽管 ShowModalDialog 方法只能在完全受信任的窗体中使用，但如果在窗体中指定了 HTML 任务窗格，或者通过使用 Windows 窗体，则可以使用动态 HTML (DHTML) 对象模型的 showModalDialog 方法在标准窗体中创建自定义对话框。