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 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.