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