Dialog.Display(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 a caixa de diálogo interna do Microsoft Word especificada até que o usuário a feche ou o período de 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
Objetoopcional. 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
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 interna do Word 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 interna do Word especificada, mas não executa nenhuma ação após o usuário fechar 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 executar na caixa de diálogo forem concluídas antes de o usuário fechar a caixa de diálogo-por exemplo, quando o usuário personaliza 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 concluídas normalmente após o usuário fechar a caixa de diálogo.
Use o método show se as ações que o usuário executar na caixa de diálogo são normalmente concluídas depois que o usuário fecha a caixa de diálogo-por exemplo, quando o usuário seleciona um arquivo a ser aberto usando a caixa de diálogo abrir (wdDialogFileOpen).