LayoutEngine.Layout(Object, LayoutEventArgs) Yöntem

Tanım

Ad Alanı:

System.Windows.Forms.Layout

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Düzen altyapısının bir düzen işlemi gerçekleştirmesini istemektedir.

public:
 virtual bool Layout(System::Object ^ container, System::Windows::Forms::LayoutEventArgs ^ layoutEventArgs);

public virtual bool Layout (object container, System.Windows.Forms.LayoutEventArgs layoutEventArgs);

abstract member Layout : obj * System.Windows.Forms.LayoutEventArgs -> bool
override this.Layout : obj * System.Windows.Forms.LayoutEventArgs -> bool

Public Overridable Function Layout (container As Object, layoutEventArgs As LayoutEventArgs) As Boolean

Parametreler

container

Object

Düzen altyapısının üzerinde çalışacağı kapsayıcı.

layoutEventArgs

LayoutEventArgs

Bir olaydan olay Layout bağımsız değişkeni.

Döndürülenler

Boolean

truedüzeni öğesinin üst containeröğesi tarafından yeniden gerçekleştirilecekse, aksi takdirde . false

Özel durumlar

NotSupportedException

container üzerinde düzen gerçekleştirebilen bir tür LayoutEngine değildir.

Örnekler

Aşağıdaki kod örneği, özel düzen davranışını uygulamak için yönteminin Layout kullanımını gösterir. Bu kod örneği, sınıfı için LayoutEngine sağlanan daha büyük bir örneğin parçasıdır.

public:
    virtual bool Layout(Object^ container,
        LayoutEventArgs^ layoutEventArgs) override
    {
        Control^ parent = nullptr;
        try
        {
            parent = (Control ^) container;
        }
        catch (InvalidCastException^ ex)
        {
            throw gcnew ArgumentException(
                "The parameter 'container' must be a control", "container", ex);
        }
        // Use DisplayRectangle so that parent.Padding is honored.
        Rectangle parentDisplayRectangle = parent->DisplayRectangle;
        Point nextControlLocation = parentDisplayRectangle.Location;

        for each (Control^ currentControl in parent->Controls)
        {
            // Only apply layout to visible controls.
            if (!currentControl->Visible)
            {
                continue;
            }

            // Respect the margin of the control:
            // shift over the left and the top.
            nextControlLocation.Offset(currentControl->Margin.Left,
                currentControl->Margin.Top);

            // Set the location of the control.
            currentControl->Location = nextControlLocation;

            // Set the autosized controls to their
            // autosized heights.
            if (currentControl->AutoSize)
            {
                currentControl->Size = currentControl->GetPreferredSize(
                    parentDisplayRectangle.Size);
            }

            // Move X back to the display rectangle origin.
            nextControlLocation.X = parentDisplayRectangle.X;

            // Increment Y by the height of the control
            // and the bottom margin.
            nextControlLocation.Y += currentControl->Height +
                currentControl->Margin.Bottom;
        }

        // Optional: Return whether or not the container's
        // parent should perform layout as a result of this
        // layout. Some layout engines return the value of
        // the container's AutoSize property.

        return false;
    }

public override bool Layout(
    object container,
    LayoutEventArgs layoutEventArgs)
{
    Control parent = container as Control;

    // Use DisplayRectangle so that parent.Padding is honored.
    Rectangle parentDisplayRectangle = parent.DisplayRectangle;
    Point nextControlLocation = parentDisplayRectangle.Location;

    foreach (Control c in parent.Controls)
    {
        // Only apply layout to visible controls.
        if (!c.Visible)
        {
            continue;
        }

        // Respect the margin of the control:
        // shift over the left and the top.
        nextControlLocation.Offset(c.Margin.Left, c.Margin.Top);

        // Set the location of the control.
        c.Location = nextControlLocation;

        // Set the autosized controls to their 
        // autosized heights.
        if (c.AutoSize)
        {
            c.Size = c.GetPreferredSize(parentDisplayRectangle.Size);
        }

        // Move X back to the display rectangle origin.
        nextControlLocation.X = parentDisplayRectangle.X;

        // Increment Y by the height of the control 
        // and the bottom margin.
        nextControlLocation.Y += c.Height + c.Margin.Bottom;
    }

    // Optional: Return whether or not the container's 
    // parent should perform layout as a result of this 
    // layout. Some layout engines return the value of 
    // the container's AutoSize property.

    return false;
}

Public Overrides Function Layout( _
ByVal container As Object, _
ByVal layoutEventArgs As LayoutEventArgs) As Boolean

    Dim parent As Control = container

    ' Use DisplayRectangle so that parent.Padding is honored.
    Dim parentDisplayRectangle As Rectangle = parent.DisplayRectangle
    Dim nextControlLocation As Point = parentDisplayRectangle.Location

    Dim c As Control
    For Each c In parent.Controls

        ' Only apply layout to visible controls.
        If c.Visible <> True Then
            Continue For
        End If

        ' Respect the margin of the control:
        ' shift over the left and the top.
        nextControlLocation.Offset(c.Margin.Left, c.Margin.Top)

        ' Set the location of the control.
        c.Location = nextControlLocation

        ' Set the autosized controls to their 
        ' autosized heights.
        If c.AutoSize Then
            c.Size = c.GetPreferredSize(parentDisplayRectangle.Size)
        End If

        ' Move X back to the display rectangle origin.
        nextControlLocation.X = parentDisplayRectangle.X

        ' Increment Y by the height of the control 
        ' and the bottom margin.
        nextControlLocation.Y += c.Height + c.Margin.Bottom
    Next c

    ' Optional: Return whether or not the container's 
    ' parent should perform layout as a result of this 
    ' layout. Some layout engines return the value of 
    ' the container's AutoSize property.
    Return False

End Function

Açıklamalar

Bu yöntem, düzen altyapısı parametresinde bir düzen işlemi gerçekleştirecekse çağrılır container . Düzen işleminin AffectedPropertygerekli olup olmadığını belirlemek için , AffectedComponentve AffectedControl özelliklerinin layoutEventArgs değerini kontrol edebilirsiniz.

Devralanlara Notlar

Layout(Object, LayoutEventArgs) Özel düzen davranışınızı sağlamak için yöntemini geçersiz kılın.

parametresinin container içeriğini yerleştirdiğinizde, her alt denetimin Visible özelliğini denetlediğinizden emin olun.

Düzen altyapısı mantığınız, düzenin kapsayıcının üst öğesi tarafından yeniden gerçekleştirilmesi gerektiğini belirlerse geri dönün true . Bu durum, örneğin düzen altyapısı alt denetimleri yeniden boyutlandırdığında ve kapsayıcının yeni düzene uyum sağlamak için boyutunun artırılması gerektiğini belirlediğinde ortaya çıkabilir.

Ayrıca bkz.

• LayoutEventArgs
• Nasıl yapılır: Özel Yerleşim Altyapısı Uygulama