Form.Modal Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene un valore che indica se questo form viene visualizzato come form modale.

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

Valore della proprietà

Boolean

true se il form viene visualizzato come form modale; in caso contrario, false.

Attributi

BrowsableAttribute

Esempio

Nell'esempio seguente viene utilizzata la Modal proprietà per determinare se una maschera viene visualizzata come maschera modale. Se non sono le FormBorderStyle proprietà e TopLevel vengono modificate per rendere il modulo un modulo non di primo livello con un bordo della finestra degli strumenti.

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

Commenti

Quando un modulo viene visualizzato in modo modally, non può verificarsi alcun input (tastiera o clic del mouse) tranne per gli oggetti nel form modale. Il programma deve nascondere o chiudere un modulo modale (in genere in risposta a un'azione dell'utente) prima che si verifichi l'input in un altro modulo. I moduli visualizzati in modo modally vengono in genere usati come finestre di dialogo in un'applicazione.

È possibile utilizzare questa proprietà per determinare se un modulo ottenuto da un metodo o una proprietà è stato visualizzato in modo modally.

Per visualizzare un modulo in modo modally, utilizzare il ShowDialog metodo .

Vedi anche

• ShowDialog()