(String, Object, Object, Object, Object, Object) del método UI2.ShowModalDialog

Artículo
05/12/2015

Muestra un cuadro de diálogo modal personalizado en un formulario de Microsoft InfoPath.

Espacio de nombres: Microsoft.Office.Interop.InfoPath.SemiTrust
Ensamblado: Microsoft.Office.Interop.InfoPath.SemiTrust (en Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Sintaxis

'Declaración
Function ShowModalDialog ( _
    bstrName As String, _
    varArguments As Object, _
    varHeight As Object, _
    varWidth As Object, _
    varTop As Object, _
    varLeft As Object _
) As Object
'Uso
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
)

Parámetros

bstrName
Tipo: System.String

Nombre del archivo .html utilizado para el cuadro de diálogo modal.

varArguments
Tipo: System.Object

Especifica los argumentos que hay que utilizar al mostrar el cuadro de diálogo modal. Puede ser cualquier tipo de valor, incluso una matriz de valores.

varHeight
Tipo: System.Object

Establece el alto del cuadro de diálogo modal.

varWidth
Tipo: System.Object

Establece el ancho del cuadro de diálogo modal.

varTop
Tipo: System.Object

Establece la posición superior del cuadro de diálogo modal con respecto a la esquina superior izquierda del escritorio.

varLeft
Tipo: System.Object

Establece la posición izquierda del cuadro de diálogo modal con respecto a la esquina superior izquierda del escritorio.

Valor devuelto

Tipo: System.Object
object que especifica cómo mostrar el cuadro de diálogo modal.

Implementaciones

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

Comentarios

El método ShowModalDialog permite mostrar cuadros de diálogo personalizados a los usuarios mientras rellenan un formulario de confianza. Los cuadros de diálogo personalizados se implementan como archivos .html creados en cualquier tipo de editor HTML, como Microsoft FrontPage. Puede utilizar código de secuencias de comandos en un cuadro de diálogo personalizado que interactúe con el modelo de objetos de InfoPath si pasa objetos al cuadro de diálogo personalizado utilizando el parámetro varArguments.

Para utilizar un cuadro de diálogo personalizado en un formulario de InfoPath, previamente deberá agregar el archivo .html de dicho cuadro de diálogo al conjunto de archivos de recursos del formulario, utilizando el cuadro de diálogo Archivos de recursos. El cuadro de diálogo Archivos de recursos está disponible en el menú Herramientas en modo de diseño. Una vez agregado el archivo del cuadro de diálogo al formulario, podrá utilizar el método ShowModalDialog para mostrarlo.

Aunque el método ShowModalDialog sólo se puede utilizar en formularios de plena confianza, es posible crear un cuadro de diálogo personalizado en formularios estándar mediante el método showModalDialog del modelo de objetos de HTML dinámico (DHTML) si dispone de un panel de tareas HTML especificado en el formulario o mediante un formulario Windows.

Importante

Solo se puede acceder a este miembro con formularios abiertos desde una plantilla de formulario que haya sido configurada para ejecutarse con confianza total usando la categoría Seguridad y confianza del cuadro de diálogo Opciones de formulario. Este miembro requiere confianza total para el autor de llamada inmediato y no se puede utilizar en un código de confianza parcial. Si desea más información, consulte "Utilizar bibliotecas de código que no es de plena confianza" en MSDN.

Ejemplos

En el ejemplo siguiente, se utiliza el método ShowModalDialog del objeto UIObject para mostrar un cuadro de diálogo personalizado. Obsérvese que el objeto XDocument se pasa al cuadro de diálogo personalizado utilizando el parámetro varArguments.

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

En el siguiente ejemplo se facilita el código HTML utilizado para implementar un cuadro de diálogo personalizado sencillo. Obsérvese el uso de la propiedad dialogArguments del objeto window de HTML dinámico (DHTML) para pasar los valores al cuadro de diálogo personalizado, que en este caso es el objeto XDocument del modelo de objetos de InfoPath, desde el método ShowModalDialog. Cuando un usuario hace clic en el botón Show Alert (Mostrar alerta) del cuadro de diálogo personalizado, aparece el código fuente XML del documento XML subyacente del formulario en el cuadro de mensaje.

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

Para obtener información sobre cómo utilizar el método del cuadro ShowModalDialog, vea Cómo: Mostrar alertas y cuadros de diálogo (modelo de objetos de InfoPath 2003).