Form.TopLevel プロパティ

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

Form.TopLevel プロパティ

フォームをトップレベル ウィンドウとして表示するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property TopLevel As
 Boolean

Visual Basic (使用法)

Dim instance As Form
Dim value As Boolean

value = instance.TopLevel

instance.TopLevel = value

C#

public bool TopLevel { get;
 set; }

C++

public:
property bool TopLevel {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_TopLevel ()

/** @property */
public void set_TopLevel (boolean value)

JScript

public function get TopLevel
 () : boolean

public function set TopLevel
 (value : boolean)

プロパティ値
フォームをトップレベル ウィンドウとして表示する場合は true。それ以外の場合は false。既定値は true です。

例外

例外の種類	条件
Exception	マルチ ドキュメント インターフェイス (MDI) 親フォームはトップレベル ウィンドウにする必要があります。

解説

トップレベル フォームとは、親フォームのないウィンドウ、つまりその親フォームがデスクトップ ウィンドウであるウィンドウです。トップレベル ウィンドウは、通常、アプリケーションでメイン フォームとして使用されます。

使用例

Modal プロパティを使用して、フォームをモーダル フォームとして表示するかどうかを確認する例を次に示します。モーダル フォームとして表示しない場合は、FormBorderStyle プロパティおよび TopLevel プロパティが変更され、ツール ウィンドウの境界線を持つトップレベルでないフォームを作成します。

Visual Basic

Private Sub ShowMyNonModalForm()
    Dim myForm As New Form()
    myForm.Text = "My Form"
    myForm.SetBounds(10, 10, 200, 200)

    myForm.Show()
    ' Determine if the form is modal.
    If myForm.Modal = False Then
        ' Change borderstyle and make it not a top level window.
        myForm.FormBorderStyle = FormBorderStyle.FixedToolWindow
        myForm.TopLevel = False
    End If
End Sub

C#

private void ShowMyNonModalForm()
{
    Form myForm = new Form();
    myForm.Text = "My Form";
    myForm.SetBounds(10,10,200,200);

    myForm.Show();
    // Determine if the form is modal.
    if(myForm.Modal == false)
    {
        // Change borderstyle and make it not a top level window.
        myForm.FormBorderStyle = FormBorderStyle.FixedToolWindow;
        myForm.TopLevel = false;
    }
}

C++

private:
   void ShowMyNonModalForm()
   {
      Form^ myForm = gcnew Form;
      myForm->Text = "My Form";
      myForm->SetBounds( 10, 10, 200, 200 );
      myForm->Show();

      // Determine if the form is modal.
      if ( myForm->Modal == false )
      {
         // Change borderstyle and make it not a top level window.
         myForm->FormBorderStyle = ::FormBorderStyle::FixedToolWindow;
         myForm->TopLevel = false;
      }
   }

J#

private void ShowMyNonModalForm()
{
    Form myForm = new Form();
    myForm.set_Text("My Form");
    myForm.SetBounds(10, 10, 200, 200);
    myForm.Show();

    // Determine if the form is modal.
    if (myForm.get_Modal() == false) {
        // Change borderstyle and make it not a top level window.
        myForm.set_FormBorderStyle(get_FormBorderStyle().FixedToolWindow);
        myForm.set_TopLevel(false);
    }
} //ShowMyNonModalForm

プラットフォーム

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

参照

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