Control.SuspendLayout Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Unterbricht vorübergehend die Layoutlogik für das Steuerelement.
public:
void SuspendLayout();public void SuspendLayout ();member this.SuspendLayout : unit -> unitPublic 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.
