Cómo: usar cuadros de diálogo integrados en WordHow to: Programmatically use built-in dialog boxes in Word

Cuando se trabaja con Microsoft Office Word, hay veces cuando se necesitan para mostrar cuadros de diálogo de intervención del usuario.When working with Microsoft Office Word, there are times when you need to display dialog boxes for user input. Aunque puede crear sus propios, también puede tomar el enfoque del uso de los cuadros de diálogo integrados en Word, que se exponen en el 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álogoDisplay dialog boxes

Para mostrar un cuadro de diálogo, use 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 el ThisDocument o ThisAddIn clase del 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 los miembros de cuadro de diálogo que están disponibles a través de enlace en tiempo de ejecuciónAccess 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, los proyectos donde 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, consulte enlace en tiempo de ejecución en las soluciones de Office.For more information, see Late binding in Office solutions.

En el ejemplo de código siguiente se muestra cómo usar el nombre propiedad de la abrir archivo dónde los proyectos de cuadro de diálogo en Visual Basic 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 el ThisDocument o ThisAddIn clase del 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 usar la reflexión para tener acceso a la nombre propiedad de la abrir archivo dónde los proyectos de cuadro de diálogo en Visual Basic 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 el ThisDocument o ThisAddIn clase del 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 cuadros de diálogo Word en modo oculto mediante programación 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 (instrucción) Option strict statement
Reflexión (C#)Reflection (C#)
Reflexión (Visual Basic)Reflection (Visual Basic)