Form.ShowDialog Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Memperlihatkan formulir sebagai kotak dialog modal.

Overload

Nama	Deskripsi
ShowDialog()	Memperlihatkan formulir sebagai kotak dialog modal.
ShowDialog(IWin32Window)	Memperlihatkan formulir sebagai kotak dialog modal dengan pemilik yang ditentukan.

ShowDialog()

Sumber:

Form.cs

Memperlihatkan formulir sebagai kotak dialog modal.

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

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

InvalidOperationException

Formulir yang ditampilkan sudah terlihat.

-atau-

Formulir yang ditampilkan dinonaktifkan.

-atau-

Formulir yang ditampilkan bukan jendela tingkat atas.

-atau-

Formulir yang ditampilkan sebagai kotak dialog sudah berupa formulir modal.

-atau-

Proses saat ini tidak berjalan dalam mode interaktif pengguna (untuk informasi selengkapnya, lihat UserInteractive).

Contoh

Contoh berikut menampilkan formulir sebagai kotak dialog modal dan mengevaluasi nilai pengembalian kotak dialog sebelum menentukan apakah akan membaca nilai TextBox kontrol pada formulir kotak dialog. Contoh ini mengharuskan nama FormtestDialog dibuat dan berisi TextBox kontrol bernama TextBox1. Selain itu, contoh mengharuskan kode dalam contoh ini dimuat dan dipanggil dari yang berbeda Form untuk ditampilkan testDialog sebagai kotak dialog modal. Contoh menggunakan versi ShowDialog yang menentukan pemilik untuk kotak dialog.

void ShowMyDialogBox()
{
   Form2^ testDialog = gcnew Form2;
   
   // Show testDialog as a modal dialog and determine if DialogResult = OK.
   if ( testDialog->ShowDialog( this ) == ::DialogResult::OK )
   {
      
      // Read the contents of testDialog's TextBox.
      this->txtResult->Text = testDialog->TextBox1->Text;
   }
   else
   {
      this->txtResult->Text = "Cancelled";
   }

   delete testDialog;
}

public void ShowMyDialogBox()
{
   Form2 testDialog = new Form2();

   // Show testDialog as a modal dialog and determine if DialogResult = OK.
   if (testDialog.ShowDialog(this) == DialogResult.OK)
   {
      // Read the contents of testDialog's TextBox.
      this.txtResult.Text = testDialog.TextBox1.Text;
   }
   else
   {
      this.txtResult.Text = "Cancelled";
   }
   testDialog.Dispose();
}

Public Sub ShowMyDialogBox()
    Dim testDialog As New Form2()
    
    ' Show testDialog as a modal dialog and determine if DialogResult = OK.
    If testDialog.ShowDialog(Me) = System.Windows.Forms.DialogResult.OK Then
        ' Read the contents of testDialog's TextBox.
        txtResult.Text = testDialog.TextBox1.Text
    Else
        txtResult.Text = "Cancelled"
    End If
    testDialog.Dispose()
End Sub

Keterangan

Anda dapat menggunakan metode ini untuk menampilkan kotak dialog modal di aplikasi Anda. Ketika metode ini dipanggil, kode berikut tidak dijalankan sampai setelah kotak dialog ditutup. Kotak dialog dapat ditetapkan salah satu nilai DialogResult enumerasi dengan menetapkannya ke DialogResult properti Button formulir atau dengan mengatur DialogResult properti formulir dalam kode. Nilai ini kemudian dikembalikan oleh metode ini. Anda dapat menggunakan nilai pengembalian ini untuk menentukan cara memproses tindakan yang terjadi dalam kotak dialog. Misalnya, jika kotak dialog ditutup dan mengembalikan DialogResult.Cancel nilai melalui metode ini, Anda dapat mencegah kode mengikuti panggilan ke ShowDialog agar tidak dijalankan.

Saat formulir ditampilkan sebagai kotak dialog modal, mengklik tombol Tutup (tombol dengan X di sudut kanan atas formulir) menyebabkan formulir disembunyikan dan DialogResult properti diatur ke DialogResult.Cancel. Tidak seperti formulir non-modal, Close metode tidak dipanggil oleh .NET Framework ketika pengguna mengklik tombol tutup formulir kotak dialog atau mengatur nilai DialogResult properti. Sebaliknya formulir disembunyikan dan dapat ditampilkan lagi tanpa membuat instans baru kotak dialog. Karena formulir yang ditampilkan sebagai kotak dialog disembunyikan alih-alih ditutup, Anda harus memanggil Dispose metode formulir ketika formulir tidak lagi diperlukan oleh aplikasi Anda.

Versi ShowDialog metode ini tidak menentukan formulir atau kontrol sebagai pemiliknya. Ketika versi ini dipanggil, jendela yang saat ini aktif dijadikan pemilik kotak dialog. Jika Anda ingin menentukan pemilik tertentu, gunakan versi lain dari metode ini.

Lihat juga

• DialogResult

ShowDialog(IWin32Window)

Sumber:

Form.cs

Memperlihatkan formulir sebagai kotak dialog modal dengan pemilik yang ditentukan.

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

Parameter

owner

IWin32Window

Objek apa pun yang mengimplementasikan IWin32Window yang mewakili jendela tingkat atas yang akan memiliki kotak dialog modal.

Mengembalikan

DialogResult

Salah DialogResult satu nilai.

Pengecualian

ArgumentException

Formulir yang ditentukan dalam owner parameter sama dengan formulir yang ditampilkan.

InvalidOperationException

Formulir yang ditampilkan sudah terlihat.

-atau-

Formulir yang ditampilkan dinonaktifkan.

-atau-

Formulir yang ditampilkan bukan jendela tingkat atas.

-atau-

Formulir yang ditampilkan sebagai kotak dialog sudah berupa formulir modal.

-atau-

Proses saat ini tidak berjalan dalam mode interaktif pengguna (untuk informasi selengkapnya, lihat UserInteractive).

Contoh

Contoh berikut menampilkan formulir sebagai kotak dialog modal dan mengevaluasi nilai pengembalian kotak dialog sebelum menentukan apakah akan membaca nilai TextBox kontrol pada formulir kotak dialog. Contoh ini mengharuskan nama FormForm2 dibuat dan berisi TextBox kontrol bernama TextBox1. Contoh menggunakan versi ShowDialog yang menentukan pemilik untuk kotak dialog.

void ShowMyDialogBox()
{
   Form2^ testDialog = gcnew Form2;
   
   // Show testDialog as a modal dialog and determine if DialogResult = OK.
   if ( testDialog->ShowDialog( this ) == ::DialogResult::OK )
   {
      
      // Read the contents of testDialog's TextBox.
      this->txtResult->Text = testDialog->TextBox1->Text;
   }
   else
   {
      this->txtResult->Text = "Cancelled";
   }

   delete testDialog;
}

public void ShowMyDialogBox()
{
   Form2 testDialog = new Form2();

   // Show testDialog as a modal dialog and determine if DialogResult = OK.
   if (testDialog.ShowDialog(this) == DialogResult.OK)
   {
      // Read the contents of testDialog's TextBox.
      this.txtResult.Text = testDialog.TextBox1.Text;
   }
   else
   {
      this.txtResult.Text = "Cancelled";
   }
   testDialog.Dispose();
}

Public Sub ShowMyDialogBox()
    Dim testDialog As New Form2()
    
    ' Show testDialog as a modal dialog and determine if DialogResult = OK.
    If testDialog.ShowDialog(Me) = System.Windows.Forms.DialogResult.OK Then
        ' Read the contents of testDialog's TextBox.
        txtResult.Text = testDialog.TextBox1.Text
    Else
        txtResult.Text = "Cancelled"
    End If
    testDialog.Dispose()
End Sub

Keterangan

Anda dapat menggunakan metode ini untuk menampilkan kotak dialog modal di aplikasi Anda. Ketika metode ini dipanggil, kode berikut tidak dijalankan sampai setelah kotak dialog ditutup. Kotak dialog dapat ditetapkan salah satu nilai DialogResult dengan menetapkannya ke DialogResult properti Button pada formulir atau dengan mengatur DialogResult properti formulir dalam kode. Nilai ini kemudian dikembalikan oleh metode ini. Anda dapat menggunakan nilai pengembalian ini untuk menentukan cara memproses tindakan yang terjadi dalam kotak dialog. Misalnya, jika kotak dialog ditutup dan mengembalikan DialogResult.Cancel nilai melalui metode ini, Anda dapat mencegah kode mengikuti panggilan ke ShowDialog agar tidak dijalankan.

Saat formulir ditampilkan sebagai kotak dialog modal, mengklik tombol Tutup (tombol dengan X di sudut kanan atas formulir) menyebabkan formulir disembunyikan dan DialogResult properti diatur ke DialogResult.Cancel. Tidak seperti formulir tanpa mode, Close metode tidak dipanggil oleh .NET Framework ketika pengguna mengklik tombol tutup formulir kotak dialog atau mengatur nilai DialogResult properti. Sebaliknya formulir disembunyikan dan dapat ditampilkan lagi tanpa membuat instans baru kotak dialog. Karena formulir yang ditampilkan sebagai kotak dialog disembunyikan alih-alih ditutup, Anda harus memanggil Dispose metode formulir ketika formulir tidak lagi diperlukan oleh aplikasi Anda.

Versi ShowDialog metode ini memungkinkan Anda menentukan formulir tertentu yang akan memiliki kotak dialog yang ditampilkan.

Lihat juga

• DialogResult