Control.SuspendLayout Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Sospende temporaneamente la logica di layout per il controllo.

public:
 void SuspendLayout();

public void SuspendLayout ();

member this.SuspendLayout : unit -> unit

Public Sub SuspendLayout ()

Esempio

Nell'esempio di codice seguente vengono aggiunti due pulsanti a un modulo. Nell'esempio viene eseguita l'aggiunta dei pulsanti usando i SuspendLayout metodi 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

Commenti

La logica di layout del controllo viene sospesa fino a quando non viene chiamato il ResumeLayout metodo.

I SuspendLayout metodi e ResumeLayout vengono usati in combinazione per eliminare più eventi mentre si modificano più Layout attributi del controllo. Ad esempio, si chiamerebbe in genere il SuspendLayout metodo, quindi impostare le Sizeproprietà , AnchorLocation, o Dock del controllo e quindi chiamare il ResumeLayout metodo per abilitare le modifiche da apportare.

Non ci devono essere chiamate in sospeso a SuspendLayout per ResumeLayout essere chiamate correttamente.

Nota

Quando si aggiungono diversi controlli a un controllo padre, è consigliabile chiamare il SuspendLayout metodo prima di inizializzare i controlli da aggiungere. Dopo aver aggiunto i controlli al controllo padre, chiamare il ResumeLayout metodo . Ciò aumenterà le prestazioni delle applicazioni con molti controlli.

Vedi anche

• ResumeLayout()
• LayoutEngine
• Layout
• PerformLayout()
• SuspendLayout()
• InitLayout()