LayoutEngine.Layout(Object, LayoutEventArgs) Metódus

Definíció

Névtér:

System.Windows.Forms.Layout

Szerelvény:

System.Windows.Forms.dll

Forrás:

LayoutEngine.cs

Azt kéri, hogy az elrendezési motor végezzen el egy elrendezési műveletet.

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

Paraméterek

container

Object

Az a tároló, amelyen az elrendezési motor működni fog.

layoutEventArgs

LayoutEventArgs

Esemény argumentuma egy Layout eseményből.

Válaszok

Boolean

trueha az elrendezést ismét el kell végeznie a szülőnekcontainer; ellenkező esetben. false

Kivételek

NotSupportedException

container nem olyan típus, amelyen LayoutEngine el lehet végezni az elrendezést.

Példák

Az alábbi példakód bemutatja, hogy a Layout metódus az egyéni elrendezési viselkedés implementálásához használható-e. Ez a példakód egy nagyobb, az LayoutEngine osztályhoz tartozó példa része.

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

Megjegyzések

Ezt a metódust akkor hívjuk meg, ha az elrendezési motor egy elrendezési műveletet hajt végre a container paraméteren. A , AffectedPropertyés AffectedComponent a tulajdonságok AffectedControl értékét layoutEventArgsellenőrizheti, hogy szükség van-e elrendezési műveletre.

Megjegyzések az öröklőkhöz

Felülbírálja a metódust Layout(Object, LayoutEventArgs) az egyéni elrendezési viselkedés biztosításához.

A paraméter tartalmának container meghatározásakor mindenképpen ellenőrizze az Visible egyes gyermekvezérlők tulajdonságát.

Adja vissza true , ha az elrendezési motor logikája azt határozza meg, hogy a tároló szülőjének újra végre kell hajtania az elrendezést. Ez például akkor fordulhat elő, ha az elrendezési motor átméretezi a gyermekvezérlőket, és megállapítja, hogy a tárolót növelni kell az új elrendezés elhelyezéséhez.

Lásd még

• LayoutEventArgs
• Útmutató: Egyéni elrendezési motor implementálása