Control.SetTopLevel メソッド

.NET Framework クラス ライブラリ リファレンス

Control.SetTopLevel メソッド

コントロールをトップレベル コントロールとして設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Protected Sub SetTopLevel ( _
    value As Boolean _
)

Visual Basic (使用法)

Dim value As Boolean

Me.SetTopLevel(value)

C#

protected void SetTopLevel (
    bool value
)

C++

protected:
void SetTopLevel (
    bool value
)

J#

protected void SetTopLevel (
    boolean value
)

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 の値を渡すまで、フォームは表示されません。

.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

参照

関連項目
Control クラス
Control メンバ
System.Windows.Forms 名前空間
GetTopLevel