Form.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
Значение true
, если форма отображается как модальная; в противном случае — false
.
- Атрибуты
В следующем примере свойство используется для 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 метод .
Применяется к
Продукт | Версии |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9, 10 |