Form::TopLevel Property
Gets or sets a value indicating whether to display the form as a top-level window.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
[BrowsableAttribute(false)] public: property bool TopLevel { bool get (); void set (bool value); }
Property Value
Type: System::Booleantrue to display the form as a top-level window; otherwise, false. The default is true.
| Exception | Condition |
|---|---|
| Exception | A Multiple-document interface (MDI) parent form must be a top-level window. |
The following code example use 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 non-top-level form with a tool window border.
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.