Form.Modal プロパティ


フォームをモーダルとして表示するかどうかを示す値を取得します。Gets a value indicating whether this form is displayed modally.

 property bool Modal { bool get(); };
public bool Modal { get; }
member this.Modal : bool
Public ReadOnly Property Modal As Boolean



フォームをモーダルとして表示する場合は true。それ以外の場合は falsetrue if the form is displayed modally; otherwise, false.


次の例では、Modal プロパティを使用して、フォームがモーダルフォームとして表示されるかどうかを判断します。The following example uses the Modal property to determine if a form is displayed as a modal form. FormBorderStyle でない場合に TopLevel プロパティを変更して、ツールウィンドウの境界線を持つトップレベル以外のフォームにします。If it is not the FormBorderStyle and TopLevel properties are changed to make the form a non-top-level form with a tool window border.

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

      // 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;
private void ShowMyNonModalForm()
    Form myForm = new Form();
    myForm.Text = "My Form";

    // 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;
Private Sub ShowMyNonModalForm()
    Dim myForm As New Form()
    myForm.Text = "My Form"
    myForm.SetBounds(10, 10, 200, 200)

    ' 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


フォームがモーダルとして表示されている場合、モーダルフォーム上のオブジェクトを除き、入力 (キーボードまたはマウスクリック) は発生しません。When a form is displayed modally, no input (keyboard or mouse click) can occur except to objects on the modal form. プログラムでは、別のフォームへの入力が発生する前に、モーダルフォーム (通常は何らかのユーザー操作に応答) を非表示にしたり閉じたりする必要があります。The program must hide or close a modal form (usually in response to some user action) before input to another form can occur. モーダルとして表示されるフォームは、通常、アプリケーションのダイアログボックスとして使用されます。Forms that are displayed modally are typically used as dialog boxes in an application.

このプロパティを使用して、メソッドまたはプロパティから取得したフォームがモーダルとして表示されているかどうかを判断できます。You can use this property to determine whether a form that you have obtained from a method or property has been displayed modally.

フォームをモーダルとして表示するには、ShowDialog メソッドを使用します。To display a form modally use the ShowDialog method.