Form.Modal Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Source:

Form.cs

Obtiene un valor que indica si este formulario se muestra de forma modal.

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

Valor de propiedad

Boolean

true es si el formulario se muestra de forma modal; de lo contrario, false.

Atributos

BrowsableAttribute

Ejemplos

En el ejemplo siguiente se usa la Modal propiedad para determinar si un formulario se muestra como un formulario modal. Si no es y FormBorderStyleTopLevel las propiedades se cambian para convertir el formulario en un formulario que no sea de nivel superior con un borde de ventana de herramientas.

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 )
      {
         // 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)
    {
        // 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 se muestra un formulario de forma modal, no se puede producir ninguna entrada (teclado o clic del mouse), excepto los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se pueda producir la entrada a otro formulario. Los formularios que se muestran modally se usan normalmente como cuadros de diálogo en una aplicación.

Puede usar esta propiedad para determinar si se ha mostrado un formulario obtenido de un método o propiedad de forma modal.

Para mostrar un formulario de forma modal, use el ShowDialog método .

Consulte también

• ShowDialog()