Control.SuspendLayout Metoda

Definice

Dočasně pozastaví logiku rozložení ovládacího prvku.Temporarily suspends the layout logic for the control.

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á dvě tlačítka do formuláře.The following code example adds two buttons to a form. V příkladu transakce je přidání tlačítek pomocí SuspendLayout ResumeLayout metod a.The example transactions the addition of the buttons by using the SuspendLayout and ResumeLayout methods.

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.The layout logic of the control is suspended until the ResumeLayout method is called.

SuspendLayoutMetody a ResumeLayout jsou používány společně pro potlačení více Layout událostí při úpravách více atributů ovládacího prvku.The SuspendLayout and ResumeLayout methods are used in tandem to suppress multiple Layout events while you adjust multiple attributes of the control. Například byste obvykle volali SuspendLayout metodu, pak nastavili Size Location vlastnosti,, Anchor nebo Dock ovládacího prvku a pak volali ResumeLayout metodu, aby se změny projevily.For example, you would typically call the SuspendLayout method, then set the Size, Location, Anchor, or Dock properties of the control, and then call the ResumeLayout method to enable the changes to take effect.

Nesmí existovat žádná nevyřízená volání SuspendLayout pro ResumeLayout , aby bylo možné úspěšně volat.There must be no pending calls to SuspendLayout for ResumeLayout to be successfully called.

Poznámka

Při přidávání několika ovládacích prvků do nadřazeného ovládacího prvku je doporučeno volat SuspendLayout metodu před inicializací ovládacích prvků, které mají být přidány.When adding several controls to a parent control, it is recommended that you call the SuspendLayout method before initializing the controls to be added. Po přidání ovládacích prvků do nadřazeného ovládacího prvku zavolejte ResumeLayout metodu.After adding the controls to the parent control, call the ResumeLayout method. Tím se zvýší výkon aplikací s mnoha ovládacími prvky.This will increase the performance of applications with many controls.

Platí pro

Viz také