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. Les transactions de l’exemple l’ajout des boutons à l’aide de la SuspendLayout et ResumeLayout méthodes.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 le ResumeLayout méthode est appelée.The layout logic of the control is suspended until the ResumeLayout method is called.

Le SuspendLayout et ResumeLayout méthodes 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, vous appelez généralement la SuspendLayout (méthode), puis définissez le Size, Location, Anchor, ou Dock propriétés du contrôle et puis appelez le ResumeLayout méthode pour permettre 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 ResumeLayout puisse être appelé avec succès.There must be no pending calls to SuspendLayout for ResumeLayout to be successfully called.

Notes

Lorsque vous ajoutez plusieurs contrôles à un contrôle parent, il est recommandé d’appeler le 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 le ResumeLayout (méthode).After adding the controls to the parent control, call the ResumeLayout method. Cela augmente les performances des applications avec de nombreux contrôles.This will increase the performance of applications with many controls.

S’applique à

Voir aussi