CommonDialog.ShowDialog Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Esegue una finestra di dialogo comune.

Overload

ShowDialog()	Esegue una finestra di dialogo comune con un proprietario predefinito.
ShowDialog(IWin32Window)	Esegue una finestra di dialogo comune con il proprietario specificato.

ShowDialog()

Esegue una finestra di dialogo comune con un proprietario predefinito.

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

Restituisce

DialogResult

OK se l'utente sceglie OK nella finestra di dialogo; in caso contrario, Cancel

Esempio

Nell'esempio di codice seguente viene usata l'implementazione di e viene illustrata la ColorDialog creazione e la visualizzazione di una finestra di CommonDialog dialogo. In questo esempio è necessario che il metodo venga chiamato dall'interno di un modulo esistente, che dispone di un TextBox oggetto e Button posizionato su di esso.

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

Commenti

Questo metodo implementa RunDialog.

Vedi anche

• RunDialog(IntPtr)
• DialogResult

ShowDialog(IWin32Window)

Esegue una finestra di dialogo comune con il proprietario specificato.

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

Parametri

owner

IWin32Window

Qualsiasi oggetto che implementi IWin32Window che rappresenta la finestra di primo livello che sarà proprietaria della finestra di dialogo modale.

Restituisce

DialogResult

OK se l'utente fa clic su OK nella finestra di dialogo. In caso contrario, Cancel.

Commenti

Questa versione del metodo consente di specificare un modulo o un controllo specifico che possiede la finestra di ShowDialog dialogo visualizzata. Se si usa la versione di questo metodo senza parametri, la finestra di dialogo visualizzata verrà visualizzata automaticamente dalla finestra attiva dell'applicazione.