Control.Layout-Ereignis

Artikel
08/20/2007

Tritt ein, wenn ein Steuerelement seine untergeordneten Steuerelemente neu positionieren muss.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Event Layout As LayoutEventHandler
'Usage
Dim instance As Control
Dim handler As LayoutEventHandler

AddHandler instance.Layout, handler

public event LayoutEventHandler Layout

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

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

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

JScript unterstützt die Verwendung von Ereignissen, aber nicht die Deklaration von neuen Ereignissen.

Hinweise

Das Layout-Ereignis tritt ein, wenn untergeordnete Steuerelemente hinzugefügt oder entfernt werden, wenn sich die Begrenzungen eines Steuerelements ändern und wenn andere Veränderungen auftreten, die das Layout des Steuerelements beeinflussen können. Das Layout-Ereignis kann mithilfe der SuspendLayout-Methode und der ResumeLayout-Methode unterdrückt werden. Bei Layoutunterdrückung können mehrere Aktionen in einem Steuerelement ausgeführt werden, ohne bei jeder Änderung ein neues Layout erstellen zu müssen. Beim Ändern der Größe und beim Bewegen eines Steuerelements würde z. B. jede Operation ein Layout-Ereignis auslösen.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln von Ereignissen.

Beispiel

Im folgenden Codebeispiel wird ein Form mit dem Layout-Ereignis auf dem Bildschirm zentriert. Hierdurch bleibt das Formular zentriert, wenn der Benutzer die Größe ändert. Bei diesem Beispiel muss bereits ein Form-Steuerelement erstellt worden sein.

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

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

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

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

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
OnLayout
InitLayout
SuspendLayout
ResumeLayout
Control.LayoutEngine-Eigenschaft
Control.Layout-Ereignis
PerformLayout

Freigeben über