Form.Modal Egenskap

Definition

Hämtar ett värde som anger om formuläret visas modally.

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

Egenskapsvärde

trueom formuläret visas modally; annars . false

Attribut

Exempel

I följande exempel används Modal egenskapen för att avgöra om ett formulär visas som ett modalt formulär. Om det inte FormBorderStyle är egenskaperna och TopLevel ändras för att göra formuläret till ett icke-toppnivåformulär med en kantlinje för verktygsfönstret.

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

Kommentarer

När ett formulär visas modally kan inga indata (tangentbord eller musklickning) ske förutom för objekt i det modala formuläret. Programmet måste dölja eller stänga ett modalt formulär (vanligtvis som svar på någon användaråtgärd) innan indata till ett annat formulär kan ske. Formulär som visas modally används vanligtvis som dialogrutor i ett program.

Du kan använda den här egenskapen för att avgöra om ett formulär som du har fått från en metod eller egenskap har visats modally.

Om du vill visa ett formulär använder du ShowDialog metoden modally.

Gäller för

Se även