Como usar caixas de diálogo integradas no Word programaticamente

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

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para Word 2013 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Exibindo caixas de diálogo

Para exibir uma caixa de diálogo, use um dos valores da enumeração de WdWordDialog para criar um objeto de Dialog que representa a caixa de diálogo que você deseja exibir.Em seguida, chame o método de Show do objeto de Dialog .

O exemplo de código a seguir demonstra como exibir a caixa de diálogo de Abrir Arquivo .Para usar este exemplo, ele execução da classe de ThisDocument ou de ThisAddIn em seu projeto.

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

Word.Dialog dlg = Application.Dialogs[Word.WdWordDialog.wdDialogFileOpen];
dlg.Show();

Acessando membros da caixa de diálogo que estão disponíveis através de associação tardia

Alguns propriedades e métodos das caixas de diálogo em Word estão disponíveis somente através de associação tardia.No Visual Basic projetos onde Option Strict está ativado, você deve usar o reflexo para acessar esses membros.Para obter mais informações, consulte Ligação tardia em soluções do Office.

O exemplo de código demonstra como usar a propriedade de Name da caixa de diálogo de Abrir Arquivo em projetos do Visual Basic de onde Option Strict está desativado ou Visual C# se projetos que tem como alvo .NET Framework 4 ou .NET Framework 4.5.Para usar este exemplo, ele execução da classe de ThisDocument ou de ThisAddIn em seu projeto.

Private Sub TestDynamicDialog()
    Dim dialog As Word.Dialog = Application.Dialogs(Word.WdWordDialog.wdDialogFileOpen)
    dialog.Name = "Testing"
    dialog.Show()
    MessageBox.Show(dialog.Name)
End Sub

dynamic dialog = Application.Dialogs[Word.WdWordDialog.wdDialogFileOpen];
dialog.Name = "Testing";
dialog.Show();
MessageBox.Show(dialog.Name);

O exemplo de código demonstra como usar o reflexo para acessar a propriedade de Name da caixa de diálogo de Abrir Arquivo em projetos do Visual Basic onde Option Strict está ativado.Para usar este exemplo, ele execução da classe de ThisDocument ou de ThisAddIn em seu projeto.

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)

' 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))

Consulte também

Referência

Opção Strict Statement

Reflexão (C# e Visual Basic)

Conceitos

Como usar caixas de diálogo do Word no modo Oculto programaticamente

Parâmetros opcionais em soluções do Office

Outros recursos

Visão geral do modelo de objeto do Word