CommonDialog.ShowDialog Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Ejecuta un cuadro de diálogo común.

Sobrecargas

ShowDialog()	Ejecuta un cuadro de diálogo común con un propietario predeterminado.
ShowDialog(IWin32Window)	Ejecuta un cuadro de diálogo común con el propietario especificado.

ShowDialog()

Ejecuta un cuadro de diálogo común con un propietario predeterminado.

public:
 System::Windows::Forms::DialogResult ShowDialog();

public System.Windows.Forms.DialogResult ShowDialog ();

member this.ShowDialog : unit -> System.Windows.Forms.DialogResult

Public Function ShowDialog () As DialogResult

Devoluciones

DialogResult

OK si el usuario hace clic en el botón Aceptar del cuadro de diálogo; en caso contrario, Cancel

Ejemplos

En el ejemplo de código siguiente se usa la ColorDialog implementación de CommonDialog y se muestra la creación y la visualización de un cuadro de diálogo. En este ejemplo se requiere que se llame al método desde dentro de un formulario existente, que tiene un TextBox elemento y Button se coloca en él.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      ColorDialog^ MyDialog = gcnew ColorDialog;
      // Keeps the user from selecting a custom color.
      MyDialog->AllowFullOpen = false;
      // Allows the user to get help. (The default is false.)
      MyDialog->ShowHelp = true;
      // Sets the initial color select to the current text color.
      MyDialog->Color = textBox1->ForeColor;
      
      // Update the text box color if the user clicks OK 
      if ( MyDialog->ShowDialog() == ::System::Windows::Forms::DialogResult::OK )
      {
         textBox1->ForeColor = MyDialog->Color;
      }
   }

private void button1_Click(object sender, System.EventArgs e)
 {
    ColorDialog MyDialog = new ColorDialog();
    // Keeps the user from selecting a custom color.
    MyDialog.AllowFullOpen = false ;
    // Allows the user to get help. (The default is false.)
    MyDialog.ShowHelp = true ;
    // Sets the initial color select to the current text color.
    MyDialog.Color = textBox1.ForeColor ;
    
    // Update the text box color if the user clicks OK 
    if (MyDialog.ShowDialog() == DialogResult.OK)
        textBox1.ForeColor =  MyDialog.Color;
 }

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
    Dim MyDialog As New ColorDialog()
    ' Keeps the user from selecting a custom color.
    MyDialog.AllowFullOpen = False
    ' Allows the user to get help. (The default is false.)
    MyDialog.ShowHelp = True
    ' Sets the initial color select to the current text color,
    MyDialog.Color = TextBox1.ForeColor

    ' Update the text box color if the user clicks OK 
    If (MyDialog.ShowDialog() = Windows.Forms.DialogResult.OK) Then
        TextBox1.ForeColor = MyDialog.Color
    End If
End Sub

Comentarios

Este método implementa RunDialog.

Consulte también

• RunDialog(IntPtr)
• DialogResult

ShowDialog(IWin32Window)

Ejecuta un cuadro de diálogo común con el propietario especificado.

public:
 System::Windows::Forms::DialogResult ShowDialog(System::Windows::Forms::IWin32Window ^ owner);

public System.Windows.Forms.DialogResult ShowDialog (System.Windows.Forms.IWin32Window owner);

public System.Windows.Forms.DialogResult ShowDialog (System.Windows.Forms.IWin32Window? owner);

member this.ShowDialog : System.Windows.Forms.IWin32Window -> System.Windows.Forms.DialogResult

Public Function ShowDialog (owner As IWin32Window) As DialogResult

Parámetros

owner

IWin32Window

Cualquier objeto que implemente IWin32Window que representa la ventana de nivel superior que será propietaria del cuadro de diálogo modal.

Devoluciones

DialogResult

OK s el usuario hace clic en el botón Aceptar del cuadro de diálogo; en caso contrario, Cancel.

Comentarios

Esta versión del ShowDialog método permite especificar un formulario o control específico que posea el cuadro de diálogo que se muestra. Si usa la versión de este método que no tiene parámetros, el cuadro de diálogo que se muestra sería propiedad automática de la ventana activa actualmente de la aplicación.