Control.SuspendLayout Methode

Definition

Unterbricht vorübergehend die Layoutlogik für das Steuerelement.

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

Beispiele

Im folgenden Codebeispiel werden einem Formular zwei Schaltflächen hinzugefügt. Im Beispiel werden die Schaltflächen mithilfe SuspendLayout der methoden und ResumeLayout der Schaltflächen hinzugefügt.

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 Steuerelements wird angehalten, bis die ResumeLayout Methode aufgerufen wird.

Die SuspendLayout Und ResumeLayout Methoden werden zusammen verwendet, um mehrere Ereignisse zu unterdrücken, während Sie mehrere Layout Attribute des Steuerelements anpassen. Beispielsweise würden Sie die Methode in der SuspendLayout Regel aufrufen, dann die Size, LocationAnchor, , oder Dock Eigenschaften des Steuerelements festlegen und dann die ResumeLayout Methode aufrufen, um die Änderungen zu aktivieren.

Es darf keine ausstehenden Aufrufe SuspendLayout ResumeLayout vorhanden sein, um erfolgreich aufgerufen zu werden.

Hinweis

Wenn Sie einem übergeordneten Steuerelement mehrere Steuerelemente hinzufügen, wird empfohlen, die SuspendLayout Methode vor dem Initialisieren der hinzuzufügenden Steuerelemente aufzurufen. Rufen Sie nach dem Hinzufügen der Steuerelemente zum übergeordneten Steuerelement die ResumeLayout Methode auf. Dadurch wird die Leistung von Anwendungen mit vielen Steuerelementen erhöht.

Gilt für:

Siehe auch