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

En el ejemplo de código siguiente ColorDialog se usa CommonDialog la implementación de y se muestra cómo crear y mostrar un cuadro de diálogo.The following code example uses the ColorDialog implementation of CommonDialog and illustrates creating and showing a dialog box. En este ejemplo se requiere que se llame al método desde un formulario existente, que tiene TextBox un Button y colocado 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 que las subventanas seguras llamen 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 del ShowDialog método le permite especificar un formulario o control específico que será el propietario 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, el cuadro de diálogo que se muestra sería automáticamente el propietario de la ventana 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 que las subventanas seguras llamen a este método.for safe subwindows to call this method. Enumeración asociada:SafeSubWindowsAssociated enumeration: SafeSubWindows

Se aplica a