Gets a value indicating whether this form is displayed modally.
(in System.Windows.Forms.dll)
Visual Basic (Declaration)
<BrowsableAttribute(False)> _
Public ReadOnly Property Modal As Boolean
Dim instance As Form
Dim value As Boolean
value = instance.Modal
[BrowsableAttribute(false)]
public bool Modal { get; }
[BrowsableAttribute(false)]
public:
property bool Modal {
bool get ();
}
public function get Modal () : boolean
Property Value
Type:
System..::.Boolean
true if the form is displayed modally; otherwise, false.
When a form is displayed modally, no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (usually in response to some user action) before input to another form can occur. Forms that are displayed modally are typically used as dialog boxes in an application.
You can use this property to determine whether a form that you have obtained from a method or property has been displayed modally.
To display a form modally use the ShowDialog method.
The following code example uses the Modal property to determine if a form is displayed as a modal form. If it is not the FormBorderStyle and TopLevel properties are changed to make the form a non-top-level form with a tool window border.
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
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:
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;
}
}
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
.NET Framework
Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Reference