Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 9abbd1eb authored by Andrey Kulikov's avatar Andrey Kulikov Committed by Android (Google) Code Review
Browse files

Merge "Improve javadocs for ViewGroup.getChildDrawingOrder"

parents ea23c429 85c706a5
Loading
Loading
Loading
Loading
+16 −13
Original line number Diff line number Diff line
@@ -4284,35 +4284,38 @@ public abstract class ViewGroup extends View implements ViewParent, ViewManager
    }

    /**
     * Returns the index of the child to draw for this iteration. Override this
     * Converts drawing order position to container position. Override this
     * if you want to change the drawing order of children. By default, it
     * returns i.
     * returns drawingPosition.
     * <p>
     * NOTE: In order for this method to be called, you must enable child ordering
     * first by calling {@link #setChildrenDrawingOrderEnabled(boolean)}.
     *
     * @param i The current iteration.
     * @return The index of the child to draw this iteration.
     * @param drawingPosition the drawing order position.
     * @return the container position of a child for this drawing order position.
     *
     * @see #setChildrenDrawingOrderEnabled(boolean)
     * @see #isChildrenDrawingOrderEnabled()
     */
    protected int getChildDrawingOrder(int childCount, int i) {
        return i;
    protected int getChildDrawingOrder(int childCount, int drawingPosition) {
        return drawingPosition;
    }

    /**
     * The public version of getChildDrawingOrder().
     *
     * Returns the index of the child to draw for this iteration.
     * Converts drawing order position to container position.
     * <p>
     * Children are not necessarily drawn in the order in which they appear in the container.
     * ViewGroups can enable a custom ordering via {@link #setChildrenDrawingOrderEnabled(boolean)}.
     * This method returns the container position of a child that appears in the given position
     * in the current drawing order.
     *
     * @param i The current iteration.
     * @return The index of the child to draw this iteration.
     * @param drawingPosition the drawing order position.
     * @return the container position of a child for this drawing order position.
     *
     * @see #getChildDrawingOrder(int, int)}
     */
    public final int getChildDrawingOrder(int i) {
        return getChildDrawingOrder(getChildCount(), i);
    public final int getChildDrawingOrder(int drawingPosition) {
        return getChildDrawingOrder(getChildCount(), drawingPosition);
    }

    private boolean hasChildWithZ() {