Update clipToPadding docs

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

Change-Id: I3e3ae31f52fc22304eb13d88765f9f4fc6e43e66
This commit is contained in:
Chris Craik
2014-11-14 17:05:06 -08:00
parent 6c912b7d05
commit b165296a9c
2 changed files with 12 additions and 5 deletions

View File

@@ -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
*

View File

@@ -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. -->