通过

Form.TopLevel 属性

  • 项目

获取或设置一个值，该值指示是否将窗体显示为顶级窗口。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
Public Property TopLevel As Boolean
用法
Dim instance As Form
Dim value As Boolean

value = instance.TopLevel

instance.TopLevel = value

public bool TopLevel { get; set; }

public:
property bool TopLevel {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_TopLevel ()

/** @property */
public void set_TopLevel (boolean value)

public function get TopLevel () : boolean

public function set TopLevel (value : boolean)

属性值

如果为 true，则将窗体显示为顶级窗口；否则，为 false。默认为 true。

异常

异常类型 条件

Exception

多文档界面 (MDI) 父窗体必须是顶级窗口。

备注

顶级窗体是没有父窗体的窗口，或者其父窗体是桌面窗口。顶级窗口通常用作应用程序中的主窗体。

示例

下面的代码示例使用 Modal 属性来确定窗体是否显示为模式窗体。如果它不是 FormBorderStyle，TopLevel 属性将被更改以使该窗体成为具有工具窗口边界的非顶级窗体。

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;
      }
   }

private void ShowMyNonModalForm()
{
    Form myForm = new Form();
    myForm.set_Text("My Form");
    myForm.SetBounds(10, 10, 200, 200);
    myForm.Show();

    // Determine if the form is modal.
    if (myForm.get_Modal() == false) {
        // Change borderstyle and make it not a top level window.
        myForm.set_FormBorderStyle(get_FormBorderStyle().FixedToolWindow);
        myForm.set_TopLevel(false);
    }
} //ShowMyNonModalForm

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

Form 类
Form 成员
System.Windows.Forms 命名空间
TopMost