Control.SuspendLayout Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Dočasně pozastaví logiku rozložení ovládacího prvku.
public:
void SuspendLayout();
public void SuspendLayout ();
member this.SuspendLayout : unit -> unit
Public Sub SuspendLayout ()
Příklady
Následující příklad kódu přidá do formuláře dvě tlačítka. Příklad provádí přidání tlačítek pomocí SuspendLayout metod a ResumeLayout .
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
Poznámky
Logika rozložení ovládacího prvku je pozastavena, dokud ResumeLayout není volána metoda.
Metody SuspendLayout a ResumeLayout se používají v tandemu k potlačení více Layout událostí při úpravě více atributů ovládacího prvku. Například byste obvykle volali metoduSuspendLayout, pak nastavili Sizevlastnosti ovládacího prvku , LocationAnchor, nebo Dock a pak volali metoduResumeLayout, aby se změny projevily.
Aby bylo možné úspěšně volat, nesmí proběhnout SuspendLayoutResumeLayout žádná nevyřízená volání.
Poznámka
Při přidávání několika ovládacích prvků do nadřazeného ovládacího prvku se doporučuje volat metodu SuspendLayout před inicializací ovládacích prvků, které mají být přidány. Po přidání ovládacích prvků do nadřazeného ovládacího prvku zavolejte metodu ResumeLayout . Tím se zvýší výkon aplikací s mnoha ovládacími prvky.