UI2.ShowModalDialog(String, Object, Object, Object, Object, Object) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Muestra un cuadro de diálogo modal personalizado en un formulario de Microsoft Office InfoPath.
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
Parámetros
- bstrName
- String
Nombre del archivo .html utilizado para el cuadro de diálogo modal.
- varArguments
- 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
- Object
Establece el alto del cuadro de diálogo modal.
- varWidth
- Object
Establece el ancho del cuadro de diálogo modal.
- varTop
- Object
Establece la posición superior del cuadro de diálogo modal con respecto a la esquina superior izquierda del escritorio.
- varLeft
- Object
Establece la posición izquierda del cuadro de diálogo modal con respecto a la esquina superior izquierda del escritorio.
Devoluciones
object que especifica cómo mostrar el cuadro de diálogo modal.
Implementaciones
Ejemplos
En el ejemplo siguiente, se usa el método ShowModalDialog del UIObject objeto para mostrar un cuadro de diálogo personalizado. Tenga en cuenta que el XDocument objeto se pasa al cuadro de diálogo personalizado mediante el varArguments
parámetro .
thisXDocument.UI.<span class="label">ShowModalDialog</span>("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 usar el método de cuadro ShowModalDialog , vea Cómo: Mostrar alertas y cuadros de diálogo.
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 usar código de scripting 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 mediante el varArguments
parámetro .
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.