Form.Modal 属性

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

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
Public ReadOnly Property Modal As Boolean
用法
Dim instance As Form
Dim value As Boolean

value = instance.Modal

public bool Modal { get; }

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

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

public function get Modal () : boolean

属性值

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

备注

当有模式地显示窗体时，不能进行任何输入（通过键盘或鼠标单击），对模式窗体上的对象的输入除外。该程序必须隐藏或关闭模式窗体（通常是响应某个用户操作），然后才能对另一窗体进行输入。有模式显示的窗体通常用作应用程序中的对话框。

可以使用此属性确定从某方法或属性获取的窗体是否已经有模式地显示。

若要有模式地显示某窗体，请使用 ShowDialog 方法。

示例

下面的代码示例使用 Modal 属性来确定窗体是否显示为模式窗体。如果不显示为模式窗体，则将更改 FormBorderStyle 和 TopLevel 属性，以使该窗体成为具有工具窗口边框的非顶级窗体。

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

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

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

Form 类
Form 成员
System.Windows.Forms 命名空间
ShowDialog