Form.Modal プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
このフォームがモーダルに表示されるかどうかを示す値を取得します。
public:
property bool Modal { bool get(); };
[System.ComponentModel.Browsable(false)]
public bool Modal { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Modal : bool
Public ReadOnly Property Modal As Boolean
プロパティ値
true フォームがモーダルに表示される場合。それ以外の場合は false。
- 属性
例
次の例では、 Modal プロパティを使用して、フォームがモーダル フォームとして表示されるかどうかを判断します。 FormBorderStyleおよびTopLevelプロパティでない場合は、フォームをツール ウィンドウの境界線を持つ最上位以外のフォームになるように変更されます。
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 )
{
// 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)
{
// 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
注釈
フォームがモーダルに表示されている場合、モーダル フォーム上のオブジェクトを除き、入力 (キーボードまたはマウス クリック) は発生しません。 プログラムは、別のフォームへの入力を行う前に、モーダル フォームを非表示または閉じる必要があります (通常、ユーザーの操作に応じて)。 モーダルに表示されるフォームは、通常、アプリケーションのダイアログ ボックスとして使用されます。
このプロパティを使用すると、メソッドまたはプロパティから取得したフォームがモーダルに表示されているかどうかを確認できます。
フォームをモーダルで表示するには、 ShowDialog メソッドを使用します。