Form.Modal Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient une valeur indiquant si ce formulaire présente un affichage 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

Valeur de propriété

Boolean

true si le formulaire présente un affichage modal ; sinon, false.

Attributs

BrowsableAttribute

Exemples

L’exemple suivant utilise la Modal propriété pour déterminer si un formulaire est affiché en tant que formulaire modal. Si ce n’est pas le cas et TopLevel que les FormBorderStyle propriétés sont modifiées pour faire du formulaire un formulaire de niveau non supérieur avec une bordure de fenêtre outil.

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

Remarques

Lorsqu’un formulaire s’affiche modalement, aucune entrée (clavier ou clic de souris) ne peut se produire, sauf pour les objets du formulaire modal. Le programme doit masquer ou fermer un formulaire modal (généralement en réponse à une action de l’utilisateur) avant que l’entrée dans un autre formulaire puisse se produire. Les formulaires affichés modalment sont généralement utilisés comme boîtes de dialogue dans une application.

Vous pouvez utiliser cette propriété pour déterminer si un formulaire que vous avez obtenu à partir d’une méthode ou d’une propriété a été affiché modalement.

Pour afficher un formulaire de manière modale, utilisez la ShowDialog méthode.

Voir aussi

• ShowDialog()