次の方法で共有


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) ではありません。

解説

FormSetTopLevel メソッドを呼び出し、 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