Form.Modal 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取一个值，该值指示是否有模式地显示此窗体。

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

属性值

Boolean

如果该窗体进行模式显示，则为 true；否则为 false。

属性

BrowsableAttribute

示例

以下示例使用 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 请使用 方法。

另请参阅

• ShowDialog()