Control.SetTopLevel メソッド
コントロールをトップレベル コントロールとして設定します。
Protected Sub SetTopLevel( _
ByVal value As Boolean _)
[C#]
protected void SetTopLevel(boolvalue);
[C++]
protected: void SetTopLevel(boolvalue);
[JScript]
protected function SetTopLevel(
value : Boolean);
パラメータ
- value
コントロールをトップレベル コントロールとして設定する場合は true 。それ以外の場合は false 。
例外
例外の種類 | 条件 |
---|---|
InvalidOperationException | value パラメータが true に設定されていて、コントロールが ActiveX コントロールです。 |
Exception | GetTopLevel の戻り値が、 value パラメータと等しい値ではなく、 Parent プロパティが null 参照 (Visual Basic では Nothing) ではありません。 |
解説
Form の SetTopLevel メソッドを呼び出し、 false の値を渡す場合、 SetTopLevel を再び呼び出して true の値を渡すまで、フォームは表示されません。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- UIPermission (コントロールの種類が Form の場合に、そのコントロールをトップレベル コントロールとして設定するために必要なアクセス許可。このアクセス許可は、 value パラメータが true で、コントロールが ActiveX コントロールではない場合にだけ要求されます。) UIPermissionWindow.SafeTopLevelWindows (関連する列挙体)
- UIPermission (コントロールの種類が Form 以外の場合に、そのコントロールをトップレベル コントロールとして設定するために必要なアクセス許可。このアクセス許可は、 value パラメータが true で、コントロールが ActiveX コントロールではない場合にだけ要求されます。) UIPermissionWindow.AllWindows (関連する列挙体)
参照
Control クラス | Control メンバ | System.Windows.Forms 名前空間 | GetTopLevel