Control.SuspendLayout メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Control.SuspendLayout メソッド

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

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Sub SuspendLayout

Visual Basic (使用法)

Dim instance As Control

instance.SuspendLayout

public void SuspendLayout ()

C++

public:
void SuspendLayout ()

public void SuspendLayout ()

JScript

public function SuspendLayout ()

解説

ResumeLayout メソッドが呼び出されるまで、コントロールのレイアウトロジックを中断します。

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

SuspendLayout 呼び出しがゼロになっていないと、ResumeLayout を正常に呼び出すことができません。

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

メモ

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

使用例

2 つのボタンをフォームに追加するコード例を次に示します。この例では、SuspendLayout メソッドおよび ResumeLayout メソッドを使用して、ボタンの追加処理をしています。

Visual Basic

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

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

C++

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.set_Location(new Point(10, 10));
    buttonOK.set_Size(new Size(75, 25));
    buttonOK.set_Text("OK");

    Button buttonCancel = new Button();
    buttonCancel.set_Location(new Point(90, 10));
    buttonCancel.set_Size(new Size(75, 25));
    buttonCancel.set_Text("Cancel");

    this.get_Controls().AddRange(new Control[]
 {buttonOK, buttonCancel});
    this.ResumeLayout();
} //AddButtons