Form.Modal プロパティ

定義

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

public:
 property bool Modal { bool get(); };
[System.ComponentModel.Browsable(false)]
public bool Modal { get; }
member this.Modal : bool
Public ReadOnly Property Modal As Boolean

プロパティ値

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.

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;
      }
   }
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;
    }
}
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

注釈

フォームがモーダルとして表示されている場合、モーダルフォーム上のオブジェクトを除き、入力 (キーボードまたはマウスクリック) は発生しません。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.

適用対象

こちらもご覧ください