Control.SuspendLayout Methode

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. Im Beispiel wird das Hinzufügen der Schaltflächen mithilfe der Methoden SuspendLayout und ResumeLayout in Transaktionen abgewickelt.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

Hinweise

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

Die Methoden SuspendLayout und ResumeLayout werden zusammen verwendet, um mehrere Layout-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 aufzurufen, die Size-, Location-, Anchor-oder Dock-Eigenschaft des Steuer Elements festlegen und dann die ResumeLayout-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 von SuspendLayout vorhanden sein, damit ResumeLayout erfolgreich aufgerufen wird.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, die SuspendLayout-Methode vor dem Initialisieren der hinzu zufügenden Steuerelemente 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 hinzugefügt haben, können Sie die ResumeLayout-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