Control.SuspendLayout 方法

定义

临时挂起控件的布局逻辑。

C#
public void SuspendLayout();

示例

下面的代码示例将两个按钮添加到窗体。 该示例使用 SuspendLayoutResumeLayout 方法处理按钮的添加。

C#
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();
}

注解

控件的布局逻辑将挂起, ResumeLayout 直到调用 方法。

SuspendLayoutResumeLayout 方法在调整控件的多个属性时协同使用来抑制多个Layout事件。 例如,通常调用 SuspendLayout 方法,然后设置控件的 SizeLocationAnchorDock 属性,然后调用 ResumeLayout 方法以使更改生效。

对于 成功调用SuspendLayoutResumeLayout,必须没有挂起的调用。

备注

向父控件添加多个控件时,建议在初始化要添加的控件之前调用 SuspendLayout 方法。 将控件添加到父控件后,调用 ResumeLayout 方法。 这将提高具有许多控件的应用程序的性能。

适用于

产品 版本
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

另请参阅