Form.Modal Propiedad

Definición

Obtiene un valor que indica si el formulario se muestra de forma 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

Valor de propiedad

Es true si el formulario se muestra de forma modal; en caso contrario, es false.true if the form is displayed modally; otherwise, false.

Atributos

Ejemplos

En el ejemplo siguiente se usa la propiedad Modal para determinar si un formulario se muestra como un formulario modal.The following example uses the Modal property to determine if a form is displayed as a modal form. Si no es el FormBorderStyle y se cambian las propiedades de TopLevel para que el formulario sea un formulario de nivel no superior con un borde de la ventana de herramientas.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

Comentarios

Cuando un formulario se muestra de forma modal, no se puede producir ningún tipo de entrada (teclado o clic del mouse), excepto los objetos del formulario modal.When a form is displayed modally, no input (keyboard or mouse click) can occur except to objects on the modal form. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se produzca la entrada a otro formulario.The program must hide or close a modal form (usually in response to some user action) before input to another form can occur. Los formularios que se muestran de forma modal se usan normalmente como cuadros de diálogo en una aplicación.Forms that are displayed modally are typically used as dialog boxes in an application.

Puede usar esta propiedad para determinar si un formulario que ha obtenido de un método o propiedad se ha mostrado de forma modal.You can use this property to determine whether a form that you have obtained from a method or property has been displayed modally.

Para mostrar un formulario de forma modal, use el método ShowDialog.To display a form modally use the ShowDialog method.

Se aplica a

Consulte también: