Control.SuspendLayout Méthode

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Source:: Control.cs

Source:: Control.cs

Source:: Control.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Interrompt temporairement la logique de présentation du contrôle.

public:
 void SuspendLayout();

public void SuspendLayout();

member this.SuspendLayout : unit -> unit

Public Sub SuspendLayout ()

Exemples

L’exemple de code suivant ajoute deux boutons à un formulaire. L’exemple transaction l’ajout des boutons à l’aide des SuspendLayout méthodes et ResumeLayout .

private:
   void AddButtons()
   {
      // Suspend the form layout and add two buttons.
      this->SuspendLayout();
      Button^ buttonOK = gcnew Button;
      buttonOK->Location = Point(10,10);
      buttonOK->Size = System::Drawing::Size( 75, 25 );
      buttonOK->Text = "OK";
      Button^ buttonCancel = gcnew Button;
      buttonCancel->Location = Point(90,10);
      buttonCancel->Size = System::Drawing::Size( 75, 25 );
      buttonCancel->Text = "Cancel";
      array<Control^>^temp5 = {buttonOK,buttonCancel};
      this->Controls->AddRange( temp5 );
      this->ResumeLayout();
   }

private void AddButtons()
{
   // Suspend the form layout and add two buttons.
   this.SuspendLayout();
   Button buttonOK = new Button();
   buttonOK.Location = new Point(10, 10);
   buttonOK.Size = new Size(75, 25);
   buttonOK.Text = "OK";

   Button buttonCancel = new Button();
   buttonCancel.Location = new Point(90, 10);
   buttonCancel.Size = new Size(75, 25);
   buttonCancel.Text = "Cancel";
      
   this.Controls.AddRange(new Control[]{buttonOK, buttonCancel});
   this.ResumeLayout();
}

Private Sub AddButtons()
   ' Suspend the form layout and add two buttons.
   Me.SuspendLayout()
   Dim buttonOK As New Button()
   buttonOK.Location = New Point(10, 10)
   buttonOK.Size = New Size(75, 25)
   buttonOK.Text = "OK"
   
   Dim buttonCancel As New Button()
   buttonCancel.Location = New Point(90, 10)
   buttonCancel.Size = New Size(75, 25)
   buttonCancel.Text = "Cancel"
   
   Me.Controls.AddRange(New Control() {buttonOK, buttonCancel})
   Me.ResumeLayout()
End Sub

Remarques

La logique de disposition du contrôle est suspendue jusqu’à ce que la ResumeLayout méthode soit appelée.

Les SuspendLayout méthodes et ResumeLayout sont utilisées en tandem pour supprimer plusieurs Layout événements pendant que vous ajustez plusieurs attributs du contrôle. Par exemple, vous appelez généralement la SuspendLayout méthode, définissez les Sizepropriétés , Location, Anchorou Dock du contrôle, puis appelez la ResumeLayout méthode pour permettre aux modifications de prendre effet.

Il ne doit y avoir aucun appel en attente à SuspendLayout pour ResumeLayout être correctement appelé.

Remarque

Lorsque vous ajoutez plusieurs contrôles à un contrôle parent, il est recommandé d’appeler la SuspendLayout méthode avant d’initialiser les contrôles à ajouter. Après avoir ajouté les contrôles au contrôle parent, appelez la ResumeLayout méthode . Cela augmentera les performances des applications avec de nombreux contrôles.

S’applique à

Produit	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Partage via

Control.SuspendLayout Méthode

Définition

Exemples

Remarques

S’applique à

Voir aussi

Ressources supplémentaires