Form.Modal Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

Form.cs

Возвращает значение, указывающее, отображается ли форма как модальная.

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

Значение свойства

Boolean

Значение true, если форма отображается как модальная; в противном случае — false.

Атрибуты

BrowsableAttribute

Примеры

В следующем примере свойство используется для Modal определения того, отображается ли форма как модальная форма. Если это не FormBorderStyle свойства и TopLevel , изменяются, чтобы сделать форму формы не верхнего уровня с границей окна инструментов.

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

Комментарии

При модальном отображении формы ввод (нажатие клавиатуры или щелчка мышью) не может происходить, кроме объектов в модальной форме. Программа должна скрыть или закрыть модальную форму (обычно в ответ на какое-либо действие пользователя), прежде чем может произойти ввод в другую форму. Формы, отображаемые модально, обычно используются в качестве диалоговых окон в приложении.

Это свойство можно использовать для определения того, отображалась ли форма, полученная из метода или свойства, модально.

Чтобы отобразить форму модально, используйте ShowDialog метод .

См. также раздел

• ShowDialog()