Form.TopLevel Property
Gets or sets a value indicating whether to display the form as a top-level window.
[Visual Basic] Public Property TopLevel As Boolean [C#] public bool TopLevel {get; set;} [C++] public: __property bool get_TopLevel(); public: __property void set_TopLevel(bool); [JScript] public function get TopLevel() : Boolean; public function set TopLevel(Boolean);
Property Value
true to display the form as a top-level window; otherwise, false. The default is true.
Exceptions
| Exception Type | Condition |
|---|---|
| Exception | A Multiple Document Interface (MDI) parent form must be a top-level window. |
Remarks
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.
Example
[Visual Basic, C#, C++] 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.
[Visual Basic] 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 [C#] 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; } } [C++] private: void ShowMyNonModalForm() { Form* myForm = new Form(); myForm->Text = S"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; } }
[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family
See Also
Form Class | Form Members | System.Windows.Forms Namespace | TopMost