Export (0) Print
Expand All

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 Language Filter 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

Show:
© 2015 Microsoft