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 wird die Ergänzung der Schaltflächen mithilfe der Methoden und ResumeLayout Methoden SuspendLayout ausgeführt.

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 ResumeLayout werden im Tandem verwendet, um mehrere Ereignisse zu unterdrücken, während Sie mehrere Layout Attribute des Steuerelements anpassen. Beispielsweise würden Sie die SuspendLayout Methode in der Regel aufrufen, und dann die SizeAnchorLocationEigenschaften des Steuerelements festlegen, oder Dock eigenschaften des Steuerelements festlegen und dann die ResumeLayout Methode aufrufen, um die Änderungen zu aktivieren.

Es muss keine ausstehenden Anrufe vorhanden sein, SuspendLayout ResumeLayout um erfolgreich aufgerufen zu werden.

Hinweis

Wenn Sie mehrere Steuerelemente zu einem übergeordneten Steuerelement hinzufügen, empfiehlt es sich, die Methode aufzurufen, bevor Sie die SuspendLayout zu hinzufügenden Steuerelemente initialisieren. 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