Control.SuspendLayout Méthode

Définition

Interrompt temporairement la logique de présentation du contrôle.Temporarily suspends the layout logic for the control.

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.The following code example adds two buttons to a form. L’exemple transactions ajoute les boutons à l’aide des méthodes SuspendLayout et ResumeLayout.The example transactions the addition of the buttons by using the SuspendLayout and ResumeLayout methods.

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 méthode ResumeLayout soit appelée.The layout logic of the control is suspended until the ResumeLayout method is called.

Les méthodes SuspendLayout et ResumeLayout sont utilisées en tandem pour supprimer plusieurs événements Layout lorsque vous ajustez plusieurs attributs du contrôle.The SuspendLayout and ResumeLayout methods are used in tandem to suppress multiple Layout events while you adjust multiple attributes of the control. Par exemple, vous appelez généralement la méthode SuspendLayout, puis définissez les propriétés Size, Location, Anchor ou Dock du contrôle, puis appelez la méthode ResumeLayout pour que les modifications prennent effet.For example, you would typically call the SuspendLayout method, then set the Size, Location, Anchor, or Dock properties of the control, and then call the ResumeLayout method to enable the changes to take effect.

Il ne doit y avoir aucun appel en attente à SuspendLayout pour que ResumeLayout soit appelée avec succès.There must be no pending calls to SuspendLayout for ResumeLayout to be successfully called.

Notes

Quand vous ajoutez plusieurs contrôles à un contrôle parent, il est recommandé d’appeler la méthode SuspendLayout avant d’initialiser les contrôles à ajouter.When adding several controls to a parent control, it is recommended that you call the SuspendLayout method before initializing the controls to be added. Après avoir ajouté les contrôles au contrôle parent, appelez la méthode ResumeLayout.After adding the controls to the parent control, call the ResumeLayout method. Cela augmentera les performances des applications avec de nombreux contrôles.This will increase the performance of applications with many controls.

S’applique à

Voir aussi