Control.SuspendLayout Control.SuspendLayout Control.SuspendLayout Control.SuspendLayout Method

Definição

Suspende temporariamente a lógica do layout do controle.Temporarily suspends the layout logic for the control.

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

Exemplos

O exemplo de código a seguir adiciona dois botões a um formulário.The following code example adds two buttons to a form. O exemplo Transactions a adição dos botões usando os SuspendLayout métodos ResumeLayout e.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

Comentários

A lógica de layout do controle é suspensa até que ResumeLayout o método seja chamado.The layout logic of the control is suspended until the ResumeLayout method is called.

Os SuspendLayout métodos ResumeLayout e são usados em tandem para suprimir Layout vários eventos enquanto você ajusta vários atributos do controle.The SuspendLayout and ResumeLayout methods are used in tandem to suppress multiple Layout events while you adjust multiple attributes of the control. Por exemplo, você normalmente chamaria o SuspendLayout método, definiria as Sizepropriedades Location, Anchor, ou Dock do controle e, em seguida, chamaria ResumeLayout o método para permitir que as alterações entrem em vigor.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.

Não deve haver nenhuma chamada pendente para SuspendLayout ResumeLayout para ser chamada com êxito.There must be no pending calls to SuspendLayout for ResumeLayout to be successfully called.

Observação

Ao adicionar vários controles a um controle pai, é recomendável chamar o SuspendLayout método antes de inicializar os controles a serem adicionados.When adding several controls to a parent control, it is recommended that you call the SuspendLayout method before initializing the controls to be added. Depois de adicionar os controles ao controle pai, chame o ResumeLayout método.After adding the controls to the parent control, call the ResumeLayout method. Isso aumentará o desempenho dos aplicativos com muitos controles.This will increase the performance of applications with many controls.

Aplica-se a

Veja também