Form.Modal プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Form.Modal プロパティ

フォームをモーダルとして表示するかどうかを示す値を取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Modal As Boolean

Visual Basic (使用法)

Dim instance As Form
Dim value As Boolean

value = instance.Modal

public bool Modal { get;
 }

C++

public:
property bool Modal {
    bool get ();
}

/** @property */
public boolean get_Modal ()

JScript

public function get Modal
 () : boolean

プロパティ値
フォームをモーダルとして表示する場合は true。それ以外の場合は false。

解説

フォームがモーダルとして表示されている場合、そのモーダルフォーム上のオブジェクト以外でキーボードやマウスのクリックによる入力が発生することはありません。プログラムで別のフォームに対する入力を行うためには、通常はユーザーの操作に応答する形で、事前にモーダルフォームを非表示にするか、閉じる必要があります。モーダルとして表示されるフォームは、通常、アプリケーションではダイアログボックスとして使用されます。

このプロパティを使用すると、メソッドまたはプロパティによって取得したフォームがモーダルとして表示されているかどうかを確認できます。

フォームをモーダルとして表示するには、ShowDialog メソッドを使用します。

使用例

Modal プロパティを使用して、フォームをモーダルフォームとして表示するかどうかを確認する例を次に示します。モーダルフォームとして表示しない場合は、FormBorderStyle プロパティおよび TopLevel プロパティが変更され、ツールウィンドウの境界線を持つトップレベルでないフォームを作成します。

Visual Basic

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

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

C++

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.set_Text("My Form");
    myForm.SetBounds(10, 10, 200, 200);
    myForm.Show();

    // Determine if the form is modal.
    if (myForm.get_Modal() == false) {
        // Change borderstyle and make it not a top level window.
        myForm.set_FormBorderStyle(get_FormBorderStyle().FixedToolWindow);
        myForm.set_TopLevel(false);
    }
} //ShowMyNonModalForm