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

Commit b165296a authored by Chris Craik's avatar Chris Craik
Browse files

Update clipToPadding docs 

Clarify that it doesn't clip anything but children,
and only if padding is non-zero.

Change-Id: I3e3ae31f52fc22304eb13d88765f9f4fc6e43e66
parent 6c912b7d

core/java/android/view/ViewGroup.java

+10 −3
Original line number Diff line number Diff line
@@ -3528,8 +3528,11 @@ public abstract class ViewGroup extends View implements ViewParent, ViewManager 
    }



    /**

     * By default, children are clipped to the padding of the ViewGroup. This

     * allows view groups to override this behavior

     * Sets whether this ViewGroup will clip its children to its padding, if

     * padding is present.

     * <p>

     * By default, children are clipped to the padding of their parent

     * Viewgroup. This clipping behavior is only enabled if padding is non-zero.

     *

     * @param clipToPadding true to clip children to the padding of the

     *        group, false otherwise
@@ -3543,7 +3546,11 @@ public abstract class ViewGroup extends View implements ViewParent, ViewManager 
    }



    /**

     * Check if this ViewGroup is configured to clip child views to its padding.

     * Returns whether this ViewGroup will clip its children to its padding, if

     * padding is present.

     * <p>

     * By default, children are clipped to the padding of their parent

     * Viewgroup. This clipping behavior is only enabled if padding is non-zero.

     *

     * @return true if this ViewGroup clips children to its padding, false otherwise

     *

core/res/res/values/attrs.xml

+2 −2
Original line number Diff line number Diff line
@@ -2637,8 +2637,8 @@ 
             to allow the children to draw outside of their bounds. The default value of

             this property is true. -->

        <attr name="clipChildren" format="boolean" />

        <!-- Defines whether the ViewGroup will clip its drawing surface so as to exclude

             the padding area. This property is set to true by default. -->

        <!-- Defines whether the ViewGroup will clip its children to its padding, if

             padding is not zero. This property is set to true by default. -->

        <attr name="clipToPadding" format="boolean" />

        <!-- Defines the layout animation to use the first time the ViewGroup is laid out.

             Layout animations can also be started manually after the first layout. -->