CommonDialog.ShowDialog Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Ortak bir iletişim kutusu çalıştırır.

Aşırı Yüklemeler

ShowDialog()	Varsayılan sahibi olan bir ortak iletişim kutusu çalıştırır.
ShowDialog(IWin32Window)	Belirtilen sahiple ortak bir iletişim kutusu çalıştırır.

ShowDialog()

Varsayılan sahibi olan bir ortak iletişim kutusu çalıştırır.

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

Döndürülenler

DialogResult

OK kullanıcı iletişim kutusunda Tamam'a tıklarsa; aksi takdirde , Cancel.

Örnekler

Aşağıdaki kod örneği uygulamasını kullanır ColorDialog CommonDialog ve bir iletişim kutusu oluşturup göstermeyi gösterir. Bu örnek, yönteminin üzerinde ve Button bulunan mevcut bir formun TextBox içinden çağrılmış olmasını gerektirir.

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

Açıklamalar

Bu yöntem uygular RunDialog.

Ayrıca bkz.

• RunDialog(IntPtr)
• DialogResult

ShowDialog(IWin32Window)

Belirtilen sahiple ortak bir iletişim kutusu çalıştırır.

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

Parametreler

owner

IWin32Window

Kalıcı iletişim kutusuna sahip olacak en üst düzey pencereyi temsil eden herhangi IWin32Window bir nesne.

Döndürülenler

DialogResult

OK kullanıcı iletişim kutusunda Tamam'a tıklarsa; aksi takdirde , Cancel.

Açıklamalar

Yöntemin ShowDialog bu sürümü, gösterilen iletişim kutusuna sahip olacak belirli bir form veya denetim belirtmenize olanak tanır. Bu yöntemin parametresi olmayan sürümünü kullanırsanız, gösterilen iletişim kutusu otomatik olarak uygulamanızın etkin olan penceresine ait olur.