Partilhar via


CommonDialog.ShowDialog Método

Definição

Executa uma caixa de diálogo comum.

Sobrecargas

ShowDialog()

Executa uma caixa de diálogo comum com um proprietário padrão.

ShowDialog(IWin32Window)

Executa uma caixa de diálogo comum com o proprietário especificado.

ShowDialog()

Executa uma caixa de diálogo comum com um proprietário padrão.

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

Retornos

OK se o usuário clicar em OK na caixa de diálogo; caso contrário, Cancel.

Exemplos

O exemplo de código a seguir usa a ColorDialog implementação de CommonDialog e ilustra a criação e a exibição de uma caixa de diálogo. Este exemplo requer que o método seja chamado de dentro de um formulário existente, que tem um TextBox e Button colocado nele.

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

Comentários

Esse método implementa RunDialog.

Confira também

Aplica-se a

ShowDialog(IWin32Window)

Executa uma caixa de diálogo comum com o proprietário 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

Qualquer objeto que implementa IWin32Window e que representa a janela de nível superior que possuirá a caixa de diálogo modal.

Retornos

OK se o usuário clicar em OK na caixa de diálogo; caso contrário, Cancel.

Comentários

Esta versão do ShowDialog método permite que você especifique um formulário ou controle específico que será o proprietário da caixa de diálogo mostrada. Se você usar a versão desse método que não tem parâmetros, a caixa de diálogo que está sendo mostrada pertenceria automaticamente à janela ativa atualmente do aplicativo.

Aplica-se a