UI2.ShowModalDialog(String, Object, Object, Object, Object, Object) Method

Reference

Definition

Namespace:: Microsoft.Office.Interop.InfoPath.SemiTrust

Assembly:: Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Displays a custom modal dialog box in a Microsoft InfoPath form.

public:
 System::Object ^ ShowModalDialog(System::String ^ bstrName, System::Object ^ varArguments, System::Object ^ varHeight, System::Object ^ varWidth, System::Object ^ varTop, System::Object ^ varLeft);

public object ShowModalDialog (string bstrName, object varArguments, object varHeight, object varWidth, object varTop, object varLeft);

abstract member ShowModalDialog : string * obj * obj * obj * obj * obj -> obj

Public Function ShowModalDialog (bstrName As String, varArguments As Object, varHeight As Object, varWidth As Object, varTop As Object, varLeft As Object) As Object

Parameters

bstrName: String

The name of the .html file used for the modal dialog box.

varArguments: Object

Specifies the arguments to use when displaying the modal dialog box. Can be any type of value, including an array of values.

varHeight: Object

Sets the height of the modal dialog box.

varWidth: Object

Sets the width of the modal dialog box.

varTop: Object

Sets the top position of the modal dialog box relative to the upper left corner of the desktop.

varLeft: Object

Sets the left position of the modal dialog box relative to the upper left corner of the desktop.

Returns

Object

An object that specifies how to display the modal dialog box.

Implements

ShowModalDialog(String, Object, Object, Object, Object, Object)

Examples

In the following example, the ShowModalDialog method of the UIObject object is used to display a custom dialog box. Note that the XDocument object is passed to the custom dialog box using the varArguments parameter.

thisXDocument.UI.<span class="label">ShowModalDialog</span>("show.htm",(object)thisXDocument,100,100,10,10);

The following example is the HTML code used to implement a simple custom dialog box. Note the use of the dialogArguments property of the DHTML window object to get the values passed to the custom dialog box, which in this case is the XDocument object of the InfoPath object model, from the ShowModalDialog method. When a user clicks the Show Alert button in the custom dialog box, the source XML of the form's underlying XML document appears in a message box.

&lt;html&gt;
&lt;head&gt;
&lt;script language="jscript"&gt;
 var gobjXDocument = null;
 function Initialize()
 {
  // Save a reference to the XDocument object.
  if (typeof window.dialogArguments == "object")
  gobjXDocument = window.dialogArguments;
 }
&lt;/script&gt;

&lt;title&gt;A Simple Custom Dialog Box&lt;/title&gt;
&lt;/head&gt;

&lt;body style="BACKGROUND-COLOR: window" onLoad="Initialize()"&gt;
 &lt;strong&gt;Click one of the following buttons:&lt;/strong&gt;
 &lt;br/&gt;
 &lt;br/&gt;
 &lt;div id="divButtons" tyle="align:center"&gt;
 &lt;input id="btnShowAlert" style="WIDTH: 106px; HEIGHT: 24px" 
  onclick='gobjXDocument.UI.Alert(gobjXDocument.DOM.xml);' 
   type="button" size="21" value="Show Alert"&gt;&lt;/input&gt;
 &lt;input id="btnCancel" style="WIDTH: 106px; HEIGHT: 24px" 
  onclick="window.close();" type="button" size="21" 
  value="Cancel"&gt;&lt;/input&gt;
 &lt;/div&gt;
&lt;/body&gt;
&lt;/html&gt;

For information on how to use the ShowModalDialog box method, see How to: Display Alerts and Dialog Boxes (InfoPath 2003 Object Model).

Remarks

The ShowModalDialog method allows you to display custom dialog boxes to users as they fill out a fully trusted form. Custom dialog boxes are implemented as .html files created in any type of HTML editor, such as Microsoft FrontPage. You can use scripting code in a custom dialog box that interacts with the InfoPath object model if you pass objects to the custom dialog box using the varArguments parameter.

To use a custom dialog box in an InfoPath form, you must first add the .html file of the custom dialog box to the form's set of resource files by using the Resource Files dialog box. The Resource Files dialog box is available from the Tools menu in design mode. After you have added the custom dialog box file to the form, you can use the ShowModalDialog method to display it.

Although the ShowModalDialog method can only be used in fully trusted forms, you can create a custom dialog box in standard forms using the showModalDialog method of the Dynamic HTML (DHTML) object model if you have an HTML task pane specified in your form, or by using a Windows form.

Important: This member can be accessed only by forms opened from a form template that has been configured to run with full trust using the Security and Trust category of the Form Options dialog box. This member requires full trust for the immediate caller and cannot be used by partially trusted code. For more information, see "Using Libraries from Partially Trusted Code" on MSDN.

Applies to