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