Form::TopLevel Property
.NET Framework (current version)
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)
public: [BrowsableAttribute(false)] 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. |
A top-level form is a window that has no parent form, or whose parent form is the desktop window. Top-level windows are typically used as the main form in an application.
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; } }
.NET Framework
Available since 1.1
Available since 1.1
Show: