UI2.ShowModalDialog 方法 (String, Object, Object, Object, Object, Object)

在 Microsoft InfoPath 表单中显示自定义模式对话框。

命名空间:  Microsoft.Office.Interop.InfoPath.SemiTrust
程序集:  Microsoft.Office.Interop.InfoPath.SemiTrust(位于 Microsoft.Office.Interop.InfoPath.SemiTrust.dll 中)

语法

声明
Function ShowModalDialog ( _
    bstrName As String, _
    varArguments As Object, _
    varHeight As Object, _
    varWidth As Object, _
    varTop As Object, _
    varLeft As Object _
) As Object
用法
Dim instance As UI2
Dim bstrName As String
Dim varArguments As Object
Dim varHeight As Object
Dim varWidth As Object
Dim varTop As Object
Dim varLeft As Object
Dim returnValue As Object

returnValue = instance.ShowModalDialog(bstrName, _
    varArguments, varHeight, varWidth, _
    varTop, varLeft)
Object ShowModalDialog(
    string bstrName,
    Object varArguments,
    Object varHeight,
    Object varWidth,
    Object varTop,
    Object varLeft
)

参数

  • bstrName
    类型:System.String

    用于模式对话框的 .html 文件的名称。

  • varArguments
    类型:System.Object

    指定显示模式对话框时要使用的参数。可以是任何类型的值,包括数组值。

  • varHeight
    类型:System.Object

    设置模式对话框的高度。

  • varWidth
    类型:System.Object

    设置模式对话框的宽度。

  • varTop
    类型:System.Object

    设置模式对话框的顶部相对于桌面左上角的位置。

  • varLeft
    类型:System.Object

    设置模式对话框的左侧相对于桌面左上角的位置。

返回值

类型:System.Object
一个用来指定如何显示模式对话框的 object。

实现

UI.ShowModalDialog(String, Object, Object, Object, Object, Object)

备注

通过 ShowModalDialog 方法,可以在用户填写完全信任的表单时向他们显示自定义的对话框。自定义对话框由 .html 文件实现,这些文件可以在任何类型的 HTML 编辑器(如 Microsoft FrontPage)中创建。如果使用 varArguments 参数将对象传递给自定义对话框,则可以在自定义对话框中使用能够与 InfoPath 对象模型进行交互的脚本代码。

若要在 InfoPath 表单中使用自定义对话框,必须先使用"资源文件"对话框将自定义对话框的 .html 文件添加到表单的资源文件组中。可以从设计模式中的"工具"菜单打开"资源文件"对话框。在将自定义对话框文件添加到表单中之后,可以使用 ShowModalDialog 方法显示该对话框。

尽管 ShowModalDialog 方法只能用在完全受信任的表单中,您仍可以在标准表单中使用动态 HTML (DHTML) 对象模型的 showModalDialog 方法(如果表单中指定了 HTML 任务窗格),或者通过使用 Windows 表单来创建自定义对话框。

重要

只能由从表单模板打开的表单访问此成员,已使用"表单选项"对话框"安全和信任"类别将该模板配置为以完全信任状态运行。此成员要求直接调用方的完全信任并且不能由部分信任的代码使用。有关更多信息,请参阅 MSDN 上的"使用部分信任的代码中的库"。

示例

在以下示例中,UIObject 对象的 ShowModalDialog 方法用于显示自定义对话框。请注意,该示例使用 varArguments 参数将 XDocument 对象传递给自定义对话框。

thisXDocument.UI.ShowModalDialog("show.htm",(object)thisXDocument,100,100,10,10);

以下示例是用于实现简单自定义对话框的 HTML 代码。请注意,该示例使用 DHTML window 对象的 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 box 方法的信息,请参阅如何:使用 InfoPath 2003 对象模型显示警告和对话框

另请参阅

引用

UI2 接口

UI2 成员

ShowModalDialog 重载

Microsoft.Office.Interop.InfoPath.SemiTrust 命名空间