Form.TopLevel プロパティ

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

Public Property TopLevel As Boolean
[C#]
public bool TopLevel {get; set;}
[C++]
public: __property bool get_TopLevel();public: __property void set_TopLevel(bool);
[JScript]
public function get TopLevel() : Boolean;public function set TopLevel(Boolean);

プロパティ値

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

例外

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

解説

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

使用例

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

 
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 = new Form();
        myForm->Text = S"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;
        }
    }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

Form クラス | Form メンバ | System.Windows.Forms 名前空間 | TopMost