Form.Modal Form.Modal Form.Modal Form.Modal Property

定義

フォームをモーダルとして表示するかどうかを示す値を取得します。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

プロパティ値

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

次のコード例では、Modalフォームがモーダル フォームとして表示されるかどうかを決定するプロパティ。The following code example uses the Modal property to determine if a form is displayed as a modal form. ない場合、FormBorderStyleTopLevelプロパティはフォーム ツール ウィンドウの境界線の最上位レベルではない形式のために変更されます。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.

適用対象

こちらもご覧ください