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

Referenz

Definition

Namespace:: Microsoft.Office.Interop.InfoPath

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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Zeigt ein benutzerdefiniertes modales Dialogfeld in einem Microsoft Office InfoPath-Formular an.

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, Optional varArguments As Object, Optional varHeight As Object, Optional varWidth As Object, Optional varTop As Object, Optional varLeft As Object) As Object

Parameter

bstrName: String

Der Name der HTML-Datei, die für das modale Dialogfeld verwendet wird.

varArguments: Object

Gibt die Argumente an, die beim Anzeigen des modalen Dialogfelds verwendet werden sollen. Dabei kann es sich um einen Wert eines beliebigen Typs einschließlich eines Wertearrays handeln.

varHeight: Object

Legt die Höhe des modalen Dialogfelds fest.

varWidth: Object

Legt die Breite des modalen Dialogfelds fest.

varTop: Object

Legt die Position des oberen Randes des modalen Dialogfelds relativ zur oberen linken Ecke des Desktops fest.

varLeft: Object

Legt die Position des linken Randes des modalen Dialogfelds relativ zur oberen linken Ecke des Desktops fest.

Gibt zurück

Object

Ein object-Element, das angibt, wie das modale Dialogfeld angezeigt werden soll.

Implementiert

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

Beispiele

Im folgenden Beispiel wird die ShowModalDialog-Methode des UIObject -Objekts verwendet, um ein benutzerdefiniertes Dialogfeld anzuzeigen. Beachten Sie, dass das XDocument Objekt mithilfe des Parameters an das varArguments benutzerdefinierte Dialogfeld übergeben wird.

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

Im folgenden Beispiel wird der HTML-Code gezeigt, der verwendet wird, um ein einfaches benutzerdefiniertes Dialogfeld zu implementieren. Beachten Sie die Verwendung der dialogArguments-Eigenschaft des window-Objekts von DHTML, um die Werte von der ShowModalDialog-Methode an das benutzerdefinierte Dialogfeld (in diesem Fall handelt es sich um das XDocument-Objekt des InfoPath-Objektmodells) übergeben zu können. Wenn ein Benutzer im benutzerdefinierten Dialogfeld auf die Schaltfläche Show Alert klickt, werden die XML-Quelldaten des dem Formular zugrunde liegenden XML-Dokuments in einem Meldungsfeld angezeigt.

&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;

Informationen zur Verwendung der ShowModalDialog-Box-Methode finden Sie unter Vorgehensweise: Anzeigen von Warnungen und Dialogfeldern.

Hinweise

Die ShowModalDialog-Methode ermöglicht es Ihnen, benutzerdefinierte Dialogfelder anzuzeigen, wenn Benutzer ein vollständig vertrauenswürdiges Formular ausfüllen. Benutzerdefinierte Dialogfelder werden als HTML-Dateien implementiert, die in einem beliebigen HTML-Editor, z. B. Microsoft FrontPage, erstellt werden. Sie können Skriptcode in einem benutzerdefinierten Dialogfeld verwenden, das mit dem InfoPath-Objektmodell interagiert, wenn Sie Objekte mithilfe des Parameters an das varArguments benutzerdefinierte Dialogfeld übergeben.

Um ein benutzerdefiniertes Dialogfeld in einem InfoPath-Formular zu verwenden, müssen Sie zuerst die HTML-Datei des benutzerdefinierten Dialogfelds mithilfe des Dialogfelds "Ressourcendatei" zum Satz der Ressourcendateien des Formulars hinzufügen. Das Dialogfeld "Ressourcendatei" kann im Entwurfsmodus über das Menü "Extras" geöffnet werden. Nachdem Sie das benutzerdefinierte Dialogfeld dem Formular hinzugefügt haben, können Sie die ShowModalDialog-Methode verwenden, um das Dialogfeld anzuzeigen.

Obwohl die ShowModalDialog-Methode nur in vollständig vertrauenswürdigen Formularen verwendet werden kann, können Sie mithilfe der showModalDialog-Methode des DHTML-Objektmodells (Dynamic HTML) in Standardformularen ein benutzerdefiniertes Dialogfeld erstellen, wenn Sie in Ihrem Formular einen HTML-Aufgabenbereich angegeben haben oder indem Sie ein Windows-Formular verwenden.

Gilt für:

Freigeben über