Form.Modal Vlastnost

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá hodnotu označující, zda je tento formulář zobrazen modálně.

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

Hodnota vlastnosti

Boolean

true je-li formulář zobrazen modálně; falsev opačném případě .

Atributy: BrowsableAttribute

Příklady

Následující příklad používá Modal vlastnost k určení, zda formulář je zobrazen jako modální formulář. Pokud tomu tak není FormBorderStyle a TopLevel vlastnosti se změní tak, aby formulář, který není na nejvyšší úrovni s ohraničením okna nástroje.

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 == false )
      {
         // 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 == false)
    {
        // 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

Poznámky

Když se formulář zobrazuje modálně, nemůže dojít k žádnému vstupu (kliknutí pomocí klávesnice nebo myši) s výjimkou objektů v modálním formuláři. Program musí před vstupem do jiného formuláře skrýt nebo zavřít modální formulář (obvykle v reakci na nějakou akci uživatele). Formuláře, které se zobrazují modálně, se obvykle používají jako dialogová okna v aplikaci.

Tuto vlastnost můžete použít k určení, zda byl formulář, který jste získali z metody nebo vlastnosti, zobrazen modálně.

Pokud chcete formulář zobrazit modálně, použijte metodu ShowDialog .

Platí pro

Viz také

ShowDialog()