Control.SuspendLayout メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ソース:

Control.cs

コントロールのレイアウト ロジックを一時的に中断します。

C#

public void SuspendLayout();

例

次のコード例では、フォームに 2 つのボタンを追加します。 この例では、 メソッドと ResumeLayout メソッドを使用して、ボタンの追加をSuspendLayoutトランザクションします。

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 中断されます。

SuspendLayoutメソッドと ResumeLayout メソッドは、コントロールの複数の属性を調整しながら、複数Layoutのイベントを抑制するために同時に使用されます。 たとえば、通常は メソッドを SuspendLayout 呼び出し、コントロールの Size、 Location、 Anchorまたは Dock プロパティを設定してから、 メソッドを ResumeLayout 呼び出して変更を有効にします。

を正常に呼び出すには、 への SuspendLayout 保留中の ResumeLayout 呼び出しは必要ありません。

注意

親コントロールに複数のコントロールを追加する場合は、追加するコントロールを SuspendLayout 初期化する前に メソッドを呼び出しておくことをお勧めします。 コントロールを親コントロールに追加した後、 メソッドを呼び出します ResumeLayout 。 これにより、多くのコントロールを持つアプリケーションのパフォーマンスが向上します。

適用対象

こちらもご覧ください

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