Control.SuspendLayout Metoda

Definicja

Tymczasowo wstrzymuje logikę układu dla kontrolki.Temporarily suspends the layout logic for the control.

public:
 void SuspendLayout();
public void SuspendLayout ();
member this.SuspendLayout : unit -> unit
Public Sub SuspendLayout ()

Przykłady

Poniższy przykład kodu dodaje dwa przyciski do formularza.The following code example adds two buttons to a form. Przykład transakcji Dodawanie przycisków przy użyciu SuspendLayout ResumeLayout metod i.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

Uwagi

Logika układu kontrolki jest zawieszona do momentu ResumeLayout wywołania metody.The layout logic of the control is suspended until the ResumeLayout method is called.

SuspendLayoutMetody i ResumeLayout są używane wspólnie do pomijania wielu Layout zdarzeń podczas dostosowywania wielu atrybutów formantu.The SuspendLayout and ResumeLayout methods are used in tandem to suppress multiple Layout events while you adjust multiple attributes of the control. Na przykład zwykle wywołuje się SuspendLayout metodę, a następnie ustawia Size właściwości,, Location Anchor , lub Dock kontrolki, a następnie Wywołaj ResumeLayout metodę, aby zmiany zaczęły obowiązywać.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.

Nie ma żadnych oczekujących wywołań SuspendLayout dla programu ResumeLayout , aby można było pomyślnie wywołać.There must be no pending calls to SuspendLayout for ResumeLayout to be successfully called.

Uwaga

Podczas dodawania kilku kontrolek do kontrolki nadrzędnej zaleca się wywołanie SuspendLayout metody przed zainicjowaniem kontrolek do dodania.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 dodaniu kontrolek do kontrolki nadrzędnej, wywołaj ResumeLayout metodę.After adding the controls to the parent control, call the ResumeLayout method. Spowoduje to zwiększenie wydajności aplikacji z wieloma kontrolkami.This will increase the performance of applications with many controls.

Dotyczy

Zobacz też