Form.Modal プロパティ

フォームをモーダルとして表示するかどうかを示す値を取得します。

Public ReadOnly Property Modal As Boolean
[C#]
public bool Modal {get;}
[C++]
public: __property bool get_Modal();
[JScript]
public function get Modal() : Boolean;

プロパティ値

フォームをモーダルとして表示する場合は true 。それ以外の場合は false 。

解説

フォームがモーダルとして表示されている場合、そのモーダル フォーム上のオブジェクト以外でキーボードやマウスのクリックによる入力が発生することはありません。プログラムで別のフォームに対する入力を行うためには、通常はユーザーの操作に応答する形で、事前にモーダル フォームを非表示にするか、閉じる必要があります。モーダルとして表示されるフォームは、通常、アプリケーションではダイアログ ボックスとして使用されます。

このプロパティを使用すると、メソッドまたはプロパティによって取得したフォームがモーダルとして表示されているかどうかを確認できます。

フォームをモーダルとして表示するには、 ShowDialog メソッドを使用します。

使用例

[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 名前空間 | ShowDialog