Compartilhar via


Form.Modal Propriedade

Definição

Obtém um valor que indica se este formulário é exibido de forma restrita.

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 da propriedade

Boolean

true se o formulário for exibido de forma restrita; caso contrário, false.

Atributos

Exemplos

O exemplo a seguir usa a Modal propriedade para determinar se um formulário é exibido como um formulário modal. Se não for o e TopLevel as FormBorderStyle propriedades forem alteradas para tornar o formulário um formulário de nível não superior 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 == 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

Comentários

Quando um formulário é exibido modally, nenhuma entrada (clique no teclado ou mouse) pode ocorrer, exceto para objetos no formulário modal. O programa deve ocultar ou fechar um formulário modal (geralmente em resposta a alguma ação do usuário) antes que a entrada em outro formulário possa ocorrer. Formulários exibidos modally normalmente são usados como caixas de diálogo em um aplicativo.

Você pode usar essa propriedade para determinar se um formulário obtido de um método ou propriedade foi exibido modally.

Para exibir um formulário modally, use o ShowDialog método.

Aplica-se a

Confira também