Control.SuspendLayout Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Suspende temporariamente a lógica do layout do controle.
public:
void SuspendLayout();public void SuspendLayout ();member this.SuspendLayout : unit -> unitPublic Sub SuspendLayout ()Exemplos
O exemplo de código a seguir adiciona dois botões a um formulário. O exemplo transa a adição dos botões usando os SuspendLayout métodos e 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
Comentários
A lógica de layout do controle é suspensa até que o ResumeLayout método seja chamado.
Os SuspendLayout métodos e ResumeLayout são usados em conjunto para suprimir vários Layout eventos enquanto você ajusta vários atributos do controle. Por exemplo, você normalmente chamaria o SuspendLayout método , definiria as Sizepropriedades , Location, Anchorou Dock do controle e, em seguida, chamaria o ResumeLayout método para permitir que as alterações entrem em vigor.
Não deve haver chamadas pendentes para SuspendLayout que ResumeLayout sejam chamadas com êxito.
Observação
Ao adicionar vários controles a um controle pai, é recomendável que você chame o SuspendLayout método antes de inicializar os controles a serem adicionados. Depois de adicionar os controles ao controle pai, chame o ResumeLayout método . Isso aumentará o desempenho de aplicativos com muitos controles.
