Control.SetTopLevel 方法
将控件设置为顶级控件。
**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）
语法
声明
Protected Sub SetTopLevel ( _
value As Boolean _
)
用法
Dim value As Boolean
Me.SetTopLevel(value)
protected void SetTopLevel (
bool value
)
protected:
void SetTopLevel (
bool value
)
protected void SetTopLevel (
boolean value
)
protected function SetTopLevel (
value : boolean
)
参数
- value
true 表示将控件设置为顶级控件；false 表示不作此设置。
异常
| 异常类型 | 条件 |
|---|---|
value 参数被设置为 true 且控件是 ActiveX 控件。 |
|
GetTopLevel 返回值不等于 value 参数且 Parent 属性不为 空引用（在 Visual Basic 中为 Nothing）。 |
备注
如果调用 Form 的 SetTopLevel 方法，并传入一个 false 值，则在下次调用 SetTopLevel（传入一个 true 值）之前，该窗体将一直不可见。
.NET Framework 安全性
- UIPermission 用于将控件设置为顶级控件（如果控件的类型为 Form）。仅当 value 参数为 true，且控件不是 ActiveX 控件时才需要此权限。关联的枚举：UIPermissionWindow 的 SafeTopLevelWindows 值。
- UIPermission 如果控件是 Form 以外的任何类型，则将控件设置为顶级控件。仅当 value 参数为 true，且控件不是 ActiveX 控件时才需要此权限。关联的枚举：UIPermissionWindow 的 AllWindows 值。
平台
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