Control.Layout イベント

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

Control.Layout イベント

コントロールの子コントロールの位置を変更する必要があるときに発生します。

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

Visual Basic (宣言)

Public Event Layout As LayoutEventHandler

Visual Basic (使用法)

Dim instance As Control
Dim handler As LayoutEventHandler

AddHandler instance.Layout, handler

C#

public event LayoutEventHandler Layout

C++

public:
event LayoutEventHandler^ Layout {
    void add (LayoutEventHandler^ value);
    void remove (LayoutEventHandler^ value);
}

J#

/** @event */
public void add_Layout (LayoutEventHandler
 value)

/** @event */
public void remove_Layout (LayoutEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

Layout イベントは、子コントロールが追加または削除されるとき、コントロールの境界が変更されるとき、およびコントロールのレイアウトに影響を与える可能性があるその他の変化が発生するときに発生します。レイアウト イベントは、SuspendLayout メソッドおよび ResumeLayout メソッドを使用して中止できます。レイアウトを中断すると、各変更に対してレイアウトを実行しなくても、コントロールで複数のアクションを実行できます。たとえば、コントロールのサイズを変更して移動する場合は、各操作で Layout イベントが発生します。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

Layout イベントで画面の中央に Form を配置するコード例を次に示します。これにより、ユーザーがフォームのサイズを変更しても、フォームは中央に配置されます。この例では、Form コントロールが既に作成されている必要があります。

Visual Basic

Private Sub MyForm_Layout(ByVal
 sender As Object, _
    ByVal e As System.Windows.Forms.LayoutEventArgs)
 Handles MyBase.Layout

    ' Center the Form on the user's screen everytime it requires a Layout.
    Me.SetBounds((System.Windows.Forms.Screen.GetBounds(Me).Width
 / 2) - (Me.Width / 2), _
        (System.Windows.Forms.Screen.GetBounds(Me).Height / 2)
 - (Me.Height / 2), _
        Me.Width, Me.Height, System.Windows.Forms.BoundsSpecified.Location)
End Sub

C#

private void MyForm_Layout(object sender, System.Windows.Forms.LayoutEventArgs
 e)
{
   // Center the Form on the user's screen everytime it requires a Layout.
   this.SetBounds((Screen.GetBounds(this).Width/2)
 - (this.Width/2),
       (Screen.GetBounds(this).Height/2) - (this.Height/2)
,
       this.Width, this.Height, BoundsSpecified.Location);
    
}

C++

private:
   void MyForm_Layout( Object^ /*sender*/, System::Windows::Forms::LayoutEventArgs^
 /*e*/ )
   {
      // Center the Form on the user's screen everytime it requires
 a Layout.
      this->SetBounds( (Screen::GetBounds( this
 ).Width / 2) - (this->Width / 2), (Screen::GetBounds( this
 ).Height / 2) - (this->Height / 2), this->Width, this->Height, BoundsSpecified::Location );
   }

J#

private void MyForm_Layout(Object sender, 
    System.Windows.Forms.LayoutEventArgs e)
{
    // Center the Form on the user's screen everytime it requires a
 Layout.
    this.SetBounds(Screen.GetBounds(this).get_Width()
 
        / 2 - this.get_Width() / 2, Screen.GetBounds(this).get_Height()
 
        / 2 - this.get_Height() / 2, this.get_Width(),
 this.get_Height(), 
        BoundsSpecified.Location);
} //MyForm_Layout

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Control クラス
Control メンバ
System.Windows.Forms 名前空間
OnLayout
InitLayout
SuspendLayout
ResumeLayout
Control.LayoutEngine プロパティ
Control.Layout イベント
PerformLayout