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

Definition

Unterbricht vorübergehend die Layoutlogik für das Steuerelement.Temporarily suspends the layout logic for the control.

public:
 void SuspendLayout();
public void SuspendLayout ();
member this.SuspendLayout : unit -> unit
Public Sub SuspendLayout ()

Beispiele

Im folgenden Codebeispiel werden zwei Schaltflächen zu einem Formular hinzugefügt.The following code example adds two buttons to a form. In dem Beispiel wird das Hinzufügen der Schaltflächen mithilfe SuspendLayout der ResumeLayout -Methode und der-Methode durch TransaktionenThe 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

Hinweise

Die Layoutlogik des Steuer Elements wird angehalten ResumeLayout , bis die-Methode aufgerufen wird.The layout logic of the control is suspended until the ResumeLayout method is called.

Die SuspendLayout - ResumeLayout Methode und die-Methode werden zusammen verwendet Layout , um mehrere Ereignisse zu unterdrücken, während Sie mehrere Attribute des Steuer Elements anpassen.The SuspendLayout and ResumeLayout methods are used in tandem to suppress multiple Layout events while you adjust multiple attributes of the control. Beispielsweise würden Sie in der Regel die SuspendLayout -Methode und dann Locationdie Size Anchor-,-, Dock -oder-Eigenschaften des-Steuer Elements festlegen ResumeLayout und dann die-Methode aufzurufen, damit die Änderungen wirksam werden.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.

Es dürfen keine ausstehenden Aufrufe SuspendLayout von für ResumeLayout vorhanden sein, um erfolgreich aufgerufen werden zu können.There must be no pending calls to SuspendLayout for ResumeLayout to be successfully called.

Hinweis

Wenn Sie einem übergeordneten Steuerelement mehrere Steuerelemente hinzufügen, empfiehlt es sich SuspendLayout , vor dem Initialisieren der hinzu zufügenden Steuerelemente die-Methode aufzurufen.When adding several controls to a parent control, it is recommended that you call the SuspendLayout method before initializing the controls to be added. Nachdem Sie dem übergeordneten Steuerelement die Steuerelemente hinzu ResumeLayout gefügt haben, müssen Sie die-MethodeAfter adding the controls to the parent control, call the ResumeLayout method. Dadurch wird die Leistung von Anwendungen mit vielen Steuerelementen erhöht.This will increase the performance of applications with many controls.

Gilt für:

Siehe auch