LayoutEngine.Layout(Object, LayoutEventArgs) 메서드

정의

네임스페이스:

System.Windows.Forms.Layout

어셈블리:

System.Windows.Forms.dll

레이아웃 엔진에서 레이아웃 작업을 수행하도록 요청합니다.

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

매개 변수

container

Object

레이아웃 엔진이 작업할 컨테이너입니다.

layoutEventArgs

LayoutEventArgs

Layout 이벤트에서 가져온 이벤트 인수입니다.

반환

Boolean

container의 부모가 레이아웃을 다시 수행해야 하면 true이고, 그렇지 않으면 false입니다.

예외

NotSupportedException

container가 LayoutEngine이 레이아웃을 수행할 수 없는 형식인 경우

예제

다음 코드 예제에서는 Layout 사용자 지정 레이아웃 동작을 구현 하는 방법입니다. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 LayoutEngine 클래스입니다.

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

설명

이 메서드는 레이아웃 엔진에서 레이아웃 작업을 수행 하는 것은 container 매개 변수입니다. 값을 확인할 수 있습니다를 AffectedProperty, AffectedComponent, 및 AffectedControl 속성을 layoutEventArgs 레이아웃 작업을 필요한 경우를 결정 합니다.

상속자 참고

재정의 Layout(Object, LayoutEventArgs) 메서드를 사용자 지정 레이아웃 동작을 제공 합니다.

내용의 레이아웃 하는 경우는 container 매개 변수를 확인 해야 합니다 Visible 각 자식 컨트롤의 속성입니다.

반환 true 레이아웃 엔진 논리 결정 컨테이너의 부모에 의해 해당 레이아웃을 다시 수행 해야 합니다. 이 발생할 수 있습니다, 예를 들어 레이아웃 엔진 자식 컨트롤의 크기를 조정 하 고 컨테이너를 새 레이아웃에 맞게 크기를 늘려야 결정 하는 경우.

추가 정보

• LayoutEventArgs
• 방법: 사용자 지정 레이아웃 엔진 구현