Control.SuspendLayout Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Dočasně pozastaví logiku rozložení ovládacího prvku.

public:
 void SuspendLayout();

public void SuspendLayout ();

member this.SuspendLayout : unit -> unit

Public Sub SuspendLayout ()

Příklady

Následující příklad kódu přidá do formuláře dvě tlačítka. Příklad provádí přidání tlačítek pomocí SuspendLayout metod a 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

Poznámky

Logika rozložení ovládacího prvku je pozastavena, dokud ResumeLayout není volána metoda.

Metody SuspendLayout a ResumeLayout se používají v tandemu k potlačení více Layout událostí při úpravě více atributů ovládacího prvku. Například byste obvykle volali metoduSuspendLayout, pak nastavili Sizevlastnosti ovládacího prvku , LocationAnchor, nebo Dock a pak volali metoduResumeLayout, aby se změny projevily.

Aby bylo možné úspěšně volat, nesmí proběhnout SuspendLayoutResumeLayout žádná nevyřízená volání.

Poznámka

Při přidávání několika ovládacích prvků do nadřazeného ovládacího prvku se doporučuje volat metodu SuspendLayout před inicializací ovládacích prvků, které mají být přidány. Po přidání ovládacích prvků do nadřazeného ovládacího prvku zavolejte metodu ResumeLayout . Tím se zvýší výkon aplikací s mnoha ovládacími prvky.

Viz také

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