Dialog.Display(Object) Método

Definição

Namespace:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

Exibe a caixa de diálogo microsoft Word interna especificada até que o usuário a feche ou o tempo especificado tenha passado. Retorna um Inteiro que indica qual botão foi clicado para fechar a caixa de diálogo.

public int Display (ref object TimeOut);

abstract member Display : obj -> int

Public Function Display (Optional ByRef TimeOut As Object) As Integer

Parâmetros

TimeOut

Object

Objeto opcional. O período de tempo que o Word esperará antes de fechar a caixa de diálogo automaticamente. Uma unidade é aproximadamente 0,001 segundo. Atividades simultâneas no sistema podem aumentar o valor efetivo de tempo. Se esse argumento for omitido, a caixa de diálogo será fechada quando o usuário a fechar.

Retornos

Int32

Comentários

	-2	O botão Fechar.
	-1	O botão OK.
	0 (zero)	O botão Cancelar.
	> 0 (zero)	Um botão de comando: 1 é o primeiro botão, 2 é o segundo botão e assim por diante.

Use o Show(Object) método para mostrar a caixa de diálogo Word interna especificada e, em seguida, (se o usuário clicar no botão OK) execute as ações especificadas pelo usuário na caixa de diálogo. O método Display, por outro lado, exibe a caixa de diálogo Word interna especificada, mas não toma nenhuma ação depois que o usuário fecha a caixa de diálogo. Portanto, você deve escolher o método a ser usado da seguinte maneira:

Use o método Display se as ações que o usuário tomará na caixa de diálogo forem concluídas antes que o usuário feche a caixa de diálogo – por exemplo, quando o usuário personalizar um menu ou barra de ferramentas usando a caixa de diálogo Personalizar (wdDialogToolsCustomize). Você também pode usar o método Display se quiser ignorar as ações solicitadas pelo usuário, se essas ações forem normalmente concluídas após o usuário fechar a caixa de diálogo.

Use o método Mostrar se as ações que o usuário tomará na caixa de diálogo forem normalmente concluídas depois que o usuário fechar a caixa de diálogo – por exemplo, quando o usuário selecionar um arquivo a ser aberto usando a caixa de diálogo Abrir (wdDialogFileOpen).