Como: Usar caixas de Caixa de diálogo internas do Word

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Tipo de Projeto Projetos de nível de documento Projetos de nível de aplicativo Versão do Microsoft Office Word 2003 Word 2007 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Ao trabalhar com o Microsoft Office Word, há ocasiões em que você precisa exibir caixas de Caixa de diálogo de entrada do usuário.Embora você possa criar seus próprios, também convém usar a abordagem do uso de caixas de Caixa de diálogo internas no Word, que estão expostas na coleção Dialogs do objeto de Application.Isso permite que você acessar mais de 200 das caixas de Caixa de diálogo internas, que são representadas como enumerações.

Usar uma caixa de diálogo interna

1. Use um dos valores da enumeração WdWordDialog para criar um objeto de Dialog que representa a caixa de diálogo Word que você deseja exibir.Para usar o exemplo de código a seguir, execute-o da ThisDocument ou ThisAddIn classe seu projeto.

   Dim dlg As Word.Dialog = Application.Dialogs.Item(Word.WdWordDialog.wdDialogFileNew)
   

   Word.Dialog dlg = Application.Dialogs[Word.WdWordDialog.wdDialogFileNew];
   

2. Depois de criar a variável Dialog, você pode chamar seus métodos.

   dlg.Show()
   

   object timeOut = 0;
   dlg.Show(ref timeOut);
   

Para acessar os membros da caixa de diálogo

1. Obter o tipo de caixa de diálogo e defina a propriedade de Name a Testing.Para usar o exemplo de código a seguir, execute-o da ThisDocument ou ThisAddIn classe seu projeto.

   Observação:
   As interações com caixas de Caixa de diálogo internas do Word ocorrem por meio de ligação tardia, isso se você tiver Option Strict definida como On ou usar C#, você não pode acessar membros das caixas de Caixa de diálogo diretamente.Você deve usar as bibliotecas de Reflexo para acessar membros de caixa de diálogo.

   Dim dlg As Word.Dialog = Application.Dialogs(Word.WdWordDialog.wdDialogFileOpen)
   Dim dlgType As Type = GetType(Word.Dialog)
   
   ' Set the Name property of the dialog box.
   dlgType.InvokeMember("Name", _
       Reflection.BindingFlags.SetProperty Or _
           Reflection.BindingFlags.Public Or _
           Reflection.BindingFlags.Instance, _
       Nothing, dlg, New Object() {"Testing"}, _
       System.Globalization.CultureInfo.InvariantCulture)
   

   Word.Dialog dlg = Application.Dialogs[Word.WdWordDialog.wdDialogFileOpen];
   System.Type dlgType = typeof(Word.Dialog);
   
   // Set the Name property of the dialog box.
   dlgType.InvokeMember("Name", 
       System.Reflection.BindingFlags.SetProperty | 
           System.Reflection.BindingFlags.Public | 
           System.Reflection.BindingFlags.Instance,
       null, dlg, new object[] {"Testing"},
       System.Globalization.CultureInfo.InvariantCulture);
   

2. Mostrar a caixa de diálogo e, em seguida, mostre a propriedade Name em uma caixa de mensagem.

   ' Display the dialog box.
   dlg.Show()
   
   ' Show the Name property.
   MessageBox.Show(dlgType.InvokeMember("Name", _
       Reflection.BindingFlags.GetProperty Or _
           Reflection.BindingFlags.Public Or _
           Reflection.BindingFlags.Instance, _
       Nothing, dlg, Nothing, _
       System.Globalization.CultureInfo.InvariantCulture))
   

   // Display the dialog box.
   dlg.Show(ref missing); 
   
   // Show the Name property.
   MessageBox.Show(dlgType.InvokeMember("Name",
       System.Reflection.BindingFlags.GetProperty |
           System.Reflection.BindingFlags.Public |
           System.Reflection.BindingFlags.Instance,
       null, dlg, null,
       System.Globalization.CultureInfo.InvariantCulture).ToString());
   

Consulte também

Tarefas

Como: Usar caixas de Caixa de diálogo Word no modo oculto

Conceitos

Palavra Overview do modelo de objeto

Noções básicas sobre parâmetros opcionais in Office Solutions