Control.SuspendLayout Control.SuspendLayout Control.SuspendLayout Control.SuspendLayout Method

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 SuspendLayout des méthodes et. ResumeLayoutThe 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' ResumeLayout à ce que la méthode soit appelée.The layout logic of the control is suspended until the ResumeLayout method is called.

Les SuspendLayout méthodes ResumeLayout et sont utilisées en tandem pour supprimer plusieurs Layout événements 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, SuspendLayout vous appelez généralement la méthode, puis définissez les Sizepropriétés, Location, Anchorou Dock du contrôle, puis appelez la ResumeLayout méthode 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 pas y avoir d' SuspendLayout appels ResumeLayout en attente à pour que soit appelé 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 SuspendLayout méthode 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 ResumeLayout méthode.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