Form.Modal Propriedade

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll
Origem:
Form.cs
Origem:
Form.cs
Origem:
Form.cs
Origem:
Form.cs
Origem:
Form.cs

Obtém um valor que indica se este formulário é exibido 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 Propriedade

Boolean

true se a forma for apresentada modalmente; caso contrário, false.

Atributos
BrowsableAttribute

Exemplos

O exemplo seguinte usa a Modal propriedade para determinar se uma forma é apresentada como modal. Se não for, as FormBorderStyle propriedades e TopLevel são alteradas para tornar a forma não de topo com uma borda de janela de ferramenta.

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

Observações

Quando um formulário é exibido modalmente, não pode ocorrer qualquer entrada (clique do teclado ou do rato) exceto para objetos no formulário modal. O programa tem de ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do utilizador) antes de poder ocorrer a entrada noutro formulário. Formulários que são exibidos de forma modal são normalmente usados como caixas de diálogo numa aplicação.

Pode usar esta propriedade para determinar se um formulário que obteve de um método ou propriedade foi apresentado de forma modal.

Para apresentar um formulário de forma modal, use o ShowDialog método.

Aplica-se a

Ver também