CommonDialog.ShowDialog CommonDialog.ShowDialog CommonDialog.ShowDialog CommonDialog.ShowDialog Method

Definición

Ejecuta un cuadro de diálogo común.Runs a common dialog box.

Sobrecargas

ShowDialog() ShowDialog() ShowDialog() ShowDialog()

Ejecuta un cuadro de diálogo común con un propietario predeterminado.Runs a common dialog box with a default owner.

ShowDialog(IWin32Window) ShowDialog(IWin32Window) ShowDialog(IWin32Window) ShowDialog(IWin32Window)

Ejecuta un cuadro de diálogo común con el propietario especificado.Runs a common dialog box with the specified owner.

ShowDialog() ShowDialog() ShowDialog() ShowDialog()

Ejecuta un cuadro de diálogo común con un propietario predeterminado.Runs a common dialog box with a default owner.

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

OK si el usuario hace clic en el botón Aceptar del cuadro de diálogo; en caso contrario, CancelOK if the user clicks OK in the dialog box; otherwise, Cancel.

Ejemplos

El siguiente ejemplo de código utiliza el ColorDialog implementací CommonDialog y crear y mostrar un cuadro de diálogo se muestra.The following code example uses the ColorDialog implementation of CommonDialog and illustrates creating and showing a dialog box. Este ejemplo requiere que el método se llama desde dentro de un formulario existente, que tiene un TextBox y Button coloca en él.This example requires that the method is called from within an existing form, which has a TextBox and Button placed on it.

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.This method implements RunDialog.

Seguridad

PrintingPermission
Para imprimir desde un PrintDialog.to print from a PrintDialog. Enumeración asociada: SafePrintingAssociated enumeration: SafePrinting

UIPermission
para las ventanas secundarias seguras llamar a este método.for safe subwindows to call this method. Enumeración asociada: SafeSubWindowsAssociated enumeration: SafeSubWindows

Consulte también:

ShowDialog(IWin32Window) ShowDialog(IWin32Window) ShowDialog(IWin32Window) ShowDialog(IWin32Window)

Ejecuta un cuadro de diálogo común con el propietario especificado.Runs a common dialog box with the specified 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 IWin32Window IWin32Window IWin32Window

Cualquier objeto que implemente IWin32Window que representa la ventana de nivel superior que será propietaria del cuadro de diálogo modal.Any object that implements IWin32Window that represents the top-level window that will own the modal dialog box.

Devoluciones

OK s el usuario hace clic en el botón Aceptar del cuadro de diálogo; en caso contrario, Cancel.OK if the user clicks OK in the dialog box; otherwise, Cancel.

Comentarios

Esta versión de la ShowDialog método le permite especificar un formulario específico o un control que será propietaria del cuadro de diálogo que se muestra.This version of the ShowDialog method allows you to specify a specific form or control that will own the dialog box that is shown. Si usa la versión de este método que no tiene parámetros, se muestra el cuadro de diálogo tendrá automáticamente como propietario mediante la ventana actualmente activa de la aplicación.If you use the version of this method that has no parameters, the dialog box being shown would be owned automatically by the currently active window of your application.

Seguridad

PrintingPermission
Para imprimir desde un PrintDialog.to print from a PrintDialog. Enumeración asociada: SafePrintingAssociated enumeration: SafePrinting

UIPermission
para las ventanas secundarias seguras llamar a este método.for safe subwindows to call this method. Enumeración asociada: SafeSubWindowsAssociated enumeration: SafeSubWindows

Se aplica a