Control.SuspendLayout Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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 wird das Hinzufügen der Schaltflächen mithilfe der SuspendLayout Methoden und ResumeLayout verarbeitet.

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 Methoden und ResumeLayout werden gleichzeitig verwendet, um mehrere Layout Ereignisse zu unterdrücken, während Sie mehrere Attribute des Steuerelements anpassen. Beispielsweise rufen Sie in der Regel die SuspendLayout -Methode auf, legen dann die SizeEigenschaften , Location, Anchoroder Dock des -Steuerelements fest und rufen dann die ResumeLayout -Methode auf, damit die Änderungen wirksam werden.

Es darf keine ausstehenden Aufrufe SuspendLayout für ResumeLayout einen erfolgreichen Aufruf geben.

Hinweis

Beim Hinzufügen mehrerer Steuerelemente zu einem übergeordneten Steuerelement empfiehlt es sich, die SuspendLayout -Methode aufzurufen, bevor Sie die hinzuzufügenden Steuerelemente initialisieren. Nachdem Sie die Steuerelemente zum übergeordneten Steuerelement hinzugefügt haben, rufen Sie die -Methode auf ResumeLayout . Dies erhöht die Leistung von Anwendungen mit vielen Steuerelementen.

Weitere Informationen

• ResumeLayout()
• LayoutEngine
• Layout
• PerformLayout()
• SuspendLayout()
• InitLayout()