Cómo: Usar cuadros de diálogo integrados en Word mediante programaciónHow to: Programmatically Use Built-In Dialog Boxes in Word

Cuando se trabaja con Microsoft Office Word, hay ocasiones en que deba mostrar cuadros de diálogo proporcionados por el usuario.When working with Microsoft Office Word, there are times when you need to display dialog boxes for user input. Aunque puede crear sus propias, puede que le interese tomar el enfoque del uso de los cuadros de diálogo integrados en Word, que se exponen en la Microsoft.Office.Interop.Word.Dialogs colección de la Application objeto.Although you can create your own, you might also want to take the approach of using the built-in dialog boxes in Word, which are exposed in the Microsoft.Office.Interop.Word.Dialogs collection of the Application object. Esto le permite tener acceso a más de 200 de los cuadros de diálogo integrados, que se representan como enumeraciones.This enables you to access over 200 of the built-in dialog boxes, which are represented as enumerations.

Se aplica a: la información de este tema se aplica al documento-proyectos y agregar de VSTO de nivel-en los proyectos de Word.Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for Word. Para obtener más información, consulte características disponibles por tipo de aplicación y el proyecto de Office.For more information, see Features available by Office application and project type.

Mostrar cuadros de diálogoDisplaying Dialog Boxes

Para mostrar un cuadro de diálogo, utilice uno de los valores de la Microsoft.Office.Interop.Word.WdWordDialog enumeración para crear un Microsoft.Office.Interop.Word.Dialog objeto que representa el cuadro de diálogo que desea mostrar.To display a dialog box, use one of the values of the Microsoft.Office.Interop.Word.WdWordDialog enumeration to create a Microsoft.Office.Interop.Word.Dialog object that represents the dialog box you want to display. A continuación, llame a la Show método de la Microsoft.Office.Interop.Word.Dialog objeto.Then, call the Show method of the Microsoft.Office.Interop.Word.Dialog object.

En el ejemplo de código siguiente se muestra cómo mostrar la abrir archivo cuadro de diálogo.The following code example demonstrates how to display the File Open dialog box. Para usar este ejemplo, ejecútelo desde la ThisDocument o ThisAddIn clase en su proyecto.To use this example, run it from the ThisDocument or ThisAddIn class in your project.

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

Obtener acceso a miembros de cuadro de diálogo que están disponibles a través de enlace más tardeAccessing Dialog Box Members That Are Available Through Late Binding

Algunas propiedades y métodos de cuadros de diálogo de Word están disponibles solo a través de enlace más tarde.Some properties and methods of dialog boxes in Word are available only through late binding. En Visual Basic, proyectos where Option Strict está activado, debe usar la reflexión para tener acceso a estos miembros.In Visual Basic projects where Option Strict is on, you must use reflection to access these members. Para obtener más información, consulta Late Binding in Office Solutions.For more information, see Late Binding in Office Solutions.

En el ejemplo de código siguiente se muestra cómo utilizar el nombre propiedad de la abrir archivo cuadro de diálogo en Visual Basic proyectos where Option Strict está apagado o en Visual C# los proyectos que tienen como destino el .NET Framework 4.NET Framework 4 o .NET Framework 4.5.NET Framework 4.5.The following code example demonstrates how to use the Name property of the File Open dialog box in Visual Basic projects where Option Strict is off or in Visual C# projects that target the .NET Framework 4.NET Framework 4 or the .NET Framework 4.5.NET Framework 4.5. Para usar este ejemplo, ejecútelo desde la ThisDocument o ThisAddIn clase en su proyecto.To use this example, run it from the ThisDocument or ThisAddIn class in your project.

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

En el ejemplo de código siguiente se muestra cómo utilizar la reflexión para tener acceso a la nombre propiedad de la abrir archivo cuadro de diálogo en Visual Basic proyectos where Option Strict es en.The following code example demonstrates how to use reflection to access the Name property of the File Open dialog box in Visual Basic projects where Option Strict is on. Para usar este ejemplo, ejecútelo desde la ThisDocument o ThisAddIn clase en su proyecto.To use this example, run it from the ThisDocument or ThisAddIn class in your project.

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

Vea tambiénSee Also

Cómo: usar mediante programación los cuadros de diálogo de Word en modo oculto How to: Programmatically Use Word Dialog Boxes in Hidden Mode
Información general sobre el modelo de objetos de Word Word Object Model Overview
Parámetros opcionales en las soluciones de Office Optional Parameters in Office Solutions
Option Strict Statement (Option Strict (Instrucción))Option Strict Statement
Reflexión (C#)Reflection (C#)
Reflexión (Visual Basic)Reflection (Visual Basic)