Form.Modal Propriedade

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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: BrowsableAttribute

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

ShowDialog()

Compartilhar via