Form.Modal Свойство

Определение

Возвращает значение, указывающее, отображается ли форма как модальная.Gets a value indicating whether this form is displayed modally.

public:
 property bool Modal { bool get(); };
[System.ComponentModel.Browsable(false)]
public bool Modal { get; }
member this.Modal : bool
Public ReadOnly Property Modal As Boolean

Значение свойства

Значение true, если форма отображается как модальная; в противном случае — false.true if the form is displayed modally; otherwise, false.

Атрибуты

Примеры

В следующем примере используется свойство Modal, чтобы определить, отображается ли форма как модальная форма.The following example uses the Modal property to determine if a form is displayed as a modal form. Если свойства FormBorderStyle и TopLevel не изменены, чтобы форма стала формой не верхнего уровня с границей окна инструментов.If it is not the FormBorderStyle and TopLevel properties are changed to make the form a non-top-level form with a tool window border.

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

Комментарии

При отображении формы в модальном режиме входные данные (нажатие клавиши или мыши) не могут быть выполнены, за исключением объектов в модальной форме.When a form is displayed modally, no input (keyboard or mouse click) can occur except to objects on the modal form. Программа должна скрывать или закрывать модальную форму (обычно в ответ на какое-либо действие пользователя), прежде чем может произойти ввод в другую форму.The program must hide or close a modal form (usually in response to some user action) before input to another form can occur. Формы, которые отображаются модально, обычно используются в качестве диалоговых окон в приложении.Forms that are displayed modally are typically used as dialog boxes in an application.

С помощью этого свойства можно определить, отображается ли форма, полученная из метода или свойства, модальной.You can use this property to determine whether a form that you have obtained from a method or property has been displayed modally.

Чтобы отобразить форму в модальном режиме, используйте метод ShowDialog.To display a form modally use the ShowDialog method.

Применяется к

Дополнительно