UI2.ShowModalDialog(String, Object, Object, Object, Object, Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Exibe uma caixa de diálogo modal personalizada em um formulário infopath do Microsoft Office.
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
O nome do arquivo .html usado para a caixa de diálogo modal.
- varArguments
- Object
Especifica os argumentos a serem usados ao exibir a caixa de diálogo modal. Pode ser qualquer tipo de valor, incluindo uma matriz de valores.
- varHeight
- Object
Define a altura da caixa de diálogo modal.
- varWidth
- Object
Define a largura da caixa de diálogo modal.
- varTop
- Object
Define a posição superior da caixa de diálogo modal em relação ao canto superior esquerdo da área de trabalho.
- varLeft
- Object
Define a posição esquerda da caixa de diálogo modal em relação ao canto superior esquerdo da área de trabalho.
Retornos
Um objeto que especifica como exibir a caixa de diálogo modal.
Implementações
Exemplos
No exemplo a seguir, o método ShowModalDialog do UIObject objeto é usado para exibir uma caixa de diálogo personalizada. Observe que o XDocument objeto é passado para a caixa de diálogo personalizada usando o varArguments
parâmetro.
thisXDocument.UI.<span class="label">ShowModalDialog</span>("show.htm",(object)thisXDocument,100,100,10,10);
O exemplo a seguir é o código HTML usado para implementar uma caixa de diálogo personalizada simples. Observe o uso da propriedade dialogArguments do objeto de janela DHTML para obter os valores passados para a caixa de diálogo personalizada, que nesse caso é o objeto XDocument do modelo de objeto InfoPath, do método ShowModalDialog . Quando um usuário clica no botão Mostrar Alerta na caixa de diálogo personalizada, o XML de origem do documento XML subjacente do formulário é exibido em uma caixa de mensagem.
<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 obter informações sobre como usar o método caixa ShowModalDialog , consulte Como exibir alertas e caixas de diálogo.
Comentários
O método ShowModalDialog permite exibir caixas de diálogo personalizadas aos usuários à medida que eles preenchem um formulário totalmente confiável. As caixas de diálogo personalizadas são implementadas como arquivos .html criados em qualquer tipo de editor HTML, como o Microsoft FrontPage. Você pode usar o código de script em uma caixa de diálogo personalizada que interage com o modelo de objeto InfoPath se você passar objetos para a caixa de diálogo personalizada usando o varArguments
parâmetro.
Para usar uma caixa de diálogo personalizada em um formulário InfoPath, primeiro você deve adicionar o arquivo .html da caixa de diálogo personalizada ao conjunto de arquivos de recursos do formulário usando a caixa de diálogo Arquivos de Recursos. A caixa de diálogo Arquivos de Recursos está disponível no menu Ferramentas no modo de design. Depois de adicionar o arquivo da caixa de diálogo personalizada ao formulário, você pode usar o método ShowModalDialog para exibi-lo.
Embora o método ShowModalDialog só possa ser usado em formulários totalmente confiáveis, você pode criar uma caixa de diálogo personalizada em formulários padrão usando o método showModalDialog do modelo de objeto DHTML (Dynamic HTML) se você tiver um painel de tarefas HTML especificado em seu formulário ou usando um formulário windows.