CommonDialog.ShowDialog Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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
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.
Şunlara uygulanır
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
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.