UI2.ShowModalDialog - Méthode (String, Object, Object, Object, Object, Object)

Article
05/11/2015

Affiche une boîte de dialogue modale personnalisée dans un formulaire Microsoft Office InfoPath.

Espace de noms : Microsoft.Office.Interop.InfoPath
Assembly : Microsoft.Office.Interop.InfoPath (dans Microsoft.Office.Interop.InfoPath.dll)

Syntaxe

'Déclaration
Function ShowModalDialog ( _
    bstrName As String, _
    varArguments As Object, _
    varHeight As Object, _
    varWidth As Object, _
    varTop As Object, _
    varLeft As Object _
) As Object
'Utilisation
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
)

Paramètres

bstrName
Type : System.String

Nom du fichier .html utilisé pour la boîte de dialogue exigeant une réponse de l'utilisateur.

varArguments
Type : System.Object

Indique les arguments à utiliser lors de l'affichage de la boîte de dialogue exigeant une réponse de l'utilisateur. Il peut s'agir de n'importe quel type de valeur, y compris un tableau de valeurs.

varHeight
Type : System.Object

Définit la hauteur de la boîte de dialogue exigeant une réponse de l'utilisateur.

varWidth
Type : System.Object

Définit la largeur de la boîte de dialogue exigeant une réponse de l'utilisateur.

varTop
Type : System.Object

Définit la position supérieure de la boîte de dialogue exigeant une réponse de l'utilisateur par rapport au coin supérieur gauche du bureau.

varLeft
Type : System.Object

Définit la position gauche de la boîte de dialogue exigeant une réponse de l'utilisateur par rapport au coin supérieur gauche du bureau.

Valeur renvoyée

Type : System.Object
object qui indique comment afficher la boîte de dialogue exigeant une réponse de l'utilisateur.

Implémentations

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

Remarques

La méthode ShowModalDialog vous permet d'afficher des boîtes de dialogue personnalisées à l'attention des utilisateurs lorsqu'ils remplissent un formulaire disposant d'une autorisation totale. Les boîtes de dialogue personnalisées sont implémentées en tant que fichiers .html créés dans n'importe quel type d'éditeur HTML, tel que Microsoft FrontPage. Vous pouvez utiliser du code de script dans une boîte de dialogue personnalisée qui interagit avec le modèle objet d'InfoPath si vous transmettez des objets à la boîte de dialogue personnalisée à l'aide du paramètre varArguments.

Pour utiliser une boîte de dialogue personnalisée dans un formulaire InfoPath, vous devez d'abord ajouter le fichier .html de la boîte de dialogue personnalisée à l'ensemble de fichiers de ressources du formulaire en utilisant la boîte de dialogue Fichiers des ressources. Celle-ci est disponible à partir du menu Outils en mode Création. Une fois que vous avez ajouté le fichier de boîte de dialogue au formulaire, vous pouvez utiliser la méthode ShowModalDialog pour l'afficher.

Bien que la méthode ShowModalDialog ne peut être utilisée que pour les formulaires avec autorisation totale, vous pouvez créer une boîte de dialogue personnalisée dans des formulaires standard à l'aide de la méthode showModalDialog du modèle d'objet DHTML si un volet Office HTML est spécifié dans votre formulaire, ou en utilisant un formulaire Windows.

Exemples

Dans l'exemple suivant, la méthode ShowModalDialog de l'objet UIObject est utilisée pour afficher une boîte de dialogue personnalisée. Notez que l'objet XDocument est transmis à la boîte de dialogue personnalisée à l'aide du paramètre varArguments .

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

L'exemple suivant est le code HTML utilisé pour implémenter une boîte de dialogue personnalisée simple. Notez l'utilisation de la propriété dialogArguments de l'objet Window DHTML pour obtenir les valeurs transmises à la boîte de dialogue personnalisée, qui, dans ce cas, est l'objet XDocument du modèle objet InfoPath, à partir de la méthode ShowModalDialog. Lorsqu'un utilisateur clique sur le bouton Show Alert dans la boîte de dialogue personnalisée, le code XML source du document XML sous-jacent du formulaire s'affiche dans une boîte de message.

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

Pour plus d'informations sur la façon d'utiliser la méthode de la zone ShowModalDialog , reportez-vous à la section How to: Display Alerts and Dialog Boxes.