Control.SuspendLayout Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Suspende temporalmente la lógica de diseño del control.
public:
void SuspendLayout();
public void SuspendLayout ();
member this.SuspendLayout : unit -> unit
Public Sub SuspendLayout ()
Ejemplos
En el ejemplo de código siguiente se agregan dos botones a un formulario. En el ejemplo se realiza la adición de los botones mediante los SuspendLayout métodos y 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
Comentarios
La lógica de diseño del control se suspende hasta que se llama al ResumeLayout método .
Los SuspendLayout métodos y ResumeLayout se usan en conjunto para suprimir varios Layout eventos mientras se ajustan varios atributos del control. Por ejemplo, normalmente llamaría al SuspendLayout método , establecería las Sizepropiedades , LocationAnchor, o Dock del control y, a continuación, llamaría al ResumeLayout método para permitir que los cambios surtan efecto.
No debe haber llamadas pendientes a SuspendLayout para ResumeLayout que se llamen correctamente.
Nota
Al agregar varios controles a un control primario, se recomienda llamar al SuspendLayout método antes de inicializar los controles que se van a agregar. Después de agregar los controles al control primario, llame al ResumeLayout método . Esto aumentará el rendimiento de las aplicaciones con muchos controles.