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

Definizione

Sospende temporaneamente la logica di layout per il controllo.Temporarily suspends the layout logic for the control.

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

Esempi

Nell'esempio di codice seguente vengono aggiunti due pulsanti a un form.The following code example adds two buttons to a form. Nell'esempio viene usata la transazione per l'aggiunta dei pulsanti SuspendLayout usando ResumeLayout i metodi 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

Commenti

La logica di layout del controllo viene sospesa fino ResumeLayout a quando non viene chiamato il metodo.The layout logic of the control is suspended until the ResumeLayout method is called.

I SuspendLayout metodi ResumeLayout e vengono usati in tandem per evitare più Layout eventi mentre si regolano più attributi del controllo.The SuspendLayout and ResumeLayout methods are used in tandem to suppress multiple Layout events while you adjust multiple attributes of the control. Ad esempio, in genere si chiama il SuspendLayout metodo, quindi si impostano Anchorle Sizeproprietà Dock , Location, o del controllo e quindi si chiama ResumeLayout il metodo per rendere effettive le modifiche.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.

Non devono essere presenti chiamate in sospeso a SuspendLayout affinché ResumeLayout venga chiamato correttamente.There must be no pending calls to SuspendLayout for ResumeLayout to be successfully called.

Nota

Quando si aggiungono più controlli a un controllo padre, è consigliabile chiamare il SuspendLayout metodo prima di inizializzare i controlli da aggiungere.When adding several controls to a parent control, it is recommended that you call the SuspendLayout method before initializing the controls to be added. Dopo aver aggiunto i controlli al controllo padre, chiamare il ResumeLayout metodo.After adding the controls to the parent control, call the ResumeLayout method. Ciò consente di migliorare le prestazioni delle applicazioni con molti controlli.This will increase the performance of applications with many controls.

Si applica a

Vedi anche