Control.SuspendLayout Méthode

Définition

Suspend temporairement la logique de disposition 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 méthodes et ResumeLayout des SuspendLayout méthodes.

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 les méthodes 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, puis définissez les Sizepropriétés , Locationou AnchorDock les propriétés du contrôle, puis appelez la ResumeLayout méthode pour permettre aux modifications de prendre effet.

Il ne doit pas y avoir d’appels SuspendLayoutResumeLayout en attente pour qu’ils soient correctement appelés.

Note

Lors de l’ajout de 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 à

Voir aussi