Form.Modal Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

Form.cs

Mendapatkan nilai yang menunjukkan apakah formulir ini ditampilkan secara modal.

public:
 property bool Modal { bool get(); };

[System.ComponentModel.Browsable(false)]
public bool Modal { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Modal : bool

Public ReadOnly Property Modal As Boolean

Nilai Properti

Boolean

true jika formulir ditampilkan secara modal; jika tidak, false.

Atribut

BrowsableAttribute

Contoh

Contoh berikut menggunakan Modal properti untuk menentukan apakah formulir ditampilkan sebagai formulir modal. Jika bukan FormBorderStyle properti dan TopLevel diubah untuk membuat formulir menjadi formulir non-tingkat atas dengan batas jendela alat.

private:
   void ShowMyNonModalForm()
   {
      Form^ myForm = gcnew Form;
      myForm->Text = "My Form";
      myForm->SetBounds( 10, 10, 200, 200 );
      myForm->Show();

      // Determine if the form is modal.
      if ( !myForm->Modal )
      {
         // Change borderstyle and make it not a top level window.
         myForm->FormBorderStyle = ::FormBorderStyle::FixedToolWindow;
         myForm->TopLevel = false;
      }
   }

private void ShowMyNonModalForm()
{
    Form myForm = new Form();
    myForm.Text = "My Form";
    myForm.SetBounds(10,10,200,200);

    myForm.Show();
    // Determine if the form is modal.
    if (!myForm.Modal)
    {
        // Change borderstyle and make it not a top level window.
        myForm.FormBorderStyle = FormBorderStyle.FixedToolWindow;
        myForm.TopLevel = false;
    }
}

Private Sub ShowMyNonModalForm()
    Dim myForm As New Form()
    myForm.Text = "My Form"
    myForm.SetBounds(10, 10, 200, 200)

    myForm.Show()
    ' Determine if the form is modal.
    If myForm.Modal = False Then
        ' Change borderstyle and make it not a top level window.
        myForm.FormBorderStyle = FormBorderStyle.FixedToolWindow
        myForm.TopLevel = False
    End If
End Sub

Keterangan

Ketika formulir ditampilkan secara modal, tidak ada input (keyboard atau klik mouse) yang dapat terjadi kecuali objek pada bentuk modal. Program harus menyembunyikan atau menutup formulir modal (biasanya sebagai respons terhadap beberapa tindakan pengguna) sebelum input ke formulir lain dapat terjadi. Formulir yang ditampilkan secara modal biasanya digunakan sebagai kotak dialog dalam aplikasi.

Anda dapat menggunakan properti ini untuk menentukan apakah formulir yang telah Anda peroleh dari metode atau properti telah ditampilkan secara modal.

Untuk menampilkan formulir secara modal, gunakan ShowDialog metode .

Lihat juga

• ShowDialog()