public class ViewCompat
extends Object
java.lang.Object | |
↳ | android.support.v4.view.ViewCompat |
Known Direct Subclasses |
助手访问 View
以后向兼容的方式在API级别4之后引入的功能。
Protected constructors |
|
---|---|
ViewCompat() |
Public methods |
|
---|---|
static ViewPropertyAnimatorCompat |
animate(View view) 此方法返回一个ViewPropertyAnimator对象,该对象可用于为此视图上的特定属性设置动画。 |
static boolean |
canScrollHorizontally(View v, int direction) 检查此视图是否可以在某个方向上水平滚动。 |
static boolean |
canScrollVertically(View v, int direction) 检查该视图是否可以在某个方向上垂直滚动。 |
static int |
combineMeasuredStates(int curState, int newState) 合并由 |
static WindowInsetsCompat |
dispatchApplyWindowInsets(View view, WindowInsetsCompat insets) 请求将给定的窗口插件应用于此视图或其子视图中的其他视图。 |
static void |
dispatchFinishTemporaryDetach(View view) 通知其临时分离已结束的观点; 该视图现在被重新附加。 |
static boolean |
dispatchNestedFling(View view, float velocityX, float velocityY, boolean consumed) 向嵌套滚动父级派发一个投掷。 |
static boolean |
dispatchNestedPreFling(View view, float velocityX, float velocityY) 在此视图处理它之前,将嵌套分派给嵌套的滚动父级。 |
static boolean |
dispatchNestedPreScroll(View view, int dx, int dy, int[] consumed, int[] offsetInWindow) 在该视图消耗其任何部分之前,调度正在进行的嵌套滚动的一个步骤。 |
static boolean |
dispatchNestedScroll(View view, int dxConsumed, int dyConsumed, int dxUnconsumed, int dyUnconsumed, int[] offsetInWindow) 发送正在进行的嵌套滚动的一个步骤。 |
static void |
dispatchStartTemporaryDetach(View view) 通知它正被临时分离的观点。 |
static int |
getAccessibilityLiveRegion(View view) 获取指定View的实时区域模式。 |
static AccessibilityNodeProviderCompat |
getAccessibilityNodeProvider(View view) 获取用于管理以此视图为根的虚拟视图层次结构的提供者,并将其报告给探索窗口内容的 |
static float |
getAlpha(View view) 视图的不透明度。 |
static ColorStateList |
getBackgroundTintList(View view) 如果指定,返回应用于背景可绘制的色调。 |
static PorterDuff.Mode |
getBackgroundTintMode(View view) 如果指定,则返回用于将色调应用于背景可绘制的混合模式。 |
static Rect |
getClipBounds(View view) 返回当前的 |
static float |
getElevation(View view) 此视图相对于其父项的基础高程,以像素为单位。 |
static boolean |
getFitsSystemWindows(View v) 如果此视图适应系统窗口插入,则返回true。 |
static int |
getImportantForAccessibility(View view) 获取用于确定此视图是否对可访问性很重要的模式,即是否触发辅助功能事件并将其报告给查询屏幕的辅助功能服务。 |
static int |
getLabelFor(View view) 获取给定视图用作可访问性标签的视图的ID。 |
static int |
getLayerType(View view) 指示当前与此视图关联的图层类型。 |
static int |
getLayoutDirection(View view) 返回此视图的已解析布局方向。 |
static Matrix |
getMatrix(View view) 该视图的变换矩阵,根据当前的旋转,缩放和透视属性进行计算。 |
static int |
getMeasuredHeightAndState(View view) 按照最近致电 |
static int |
getMeasuredState(View view) 只返回状态位 |
static int |
getMeasuredWidthAndState(View view) 按照最近致电 |
static int |
getMinimumHeight(View view) 返回视图的最小高度。 |
static int |
getMinimumWidth(View view) 返回视图的最小宽度。 |
static int |
getOverScrollMode(View v) 返回此视图的过卷模式。 |
static int |
getPaddingEnd(View view) 根据解析后的布局方向返回指定视图的结束填充。 |
static int |
getPaddingStart(View view) 根据解析后的布局方向返回指定视图的开始填充。 |
static ViewParent |
getParentForAccessibility(View view) 获取父级的可访问性。 |
static float |
getPivotX(View view) |
static float |
getPivotY(View view) |
static float |
getRotation(View view) |
static float |
getRotationX(View view) |
static float |
getRotationY(View view) |
static float |
getScaleX(View view) |
static float |
getScaleY(View view) |
static int |
getScrollIndicators(View view) 返回表示启用的滚动指示符的位掩码。 |
static String |
getTransitionName(View view) 返回用于在转换中标识视图的视图的名称。 |
static float |
getTranslationX(View view) 此视图的水平位置相对于其 |
static float |
getTranslationY(View view) 该视图相对于其 |
static float |
getTranslationZ(View view) 该视图的深度位置相对于其 |
static int |
getWindowSystemUiVisibility(View view) 返回当前为整个窗口设置的系统UI可见性。 |
static float |
getX(View view) |
static float |
getY(View view) |
static float |
getZ(View view) 此视图的可视z位置,以像素为单位。 |
static boolean |
hasAccessibilityDelegate(View v) 检查提供的View是否具有附加的可访问性委托。 |
static boolean |
hasNestedScrollingParent(View view) 如果此视图具有嵌套滚动父级,则返回true。 |
static boolean |
hasOnClickListeners(View view) 返回提供的视图是否附有 |
static boolean |
hasOverlappingRendering(View view) 返回此视图是否包含重叠的内容。 |
static boolean |
hasTransientState(View view) 指示视图当前是否跟踪暂时状态,即应用程序不需要关心保存和还原,但是框架应该特别注意在可能的情况下保留。 |
static boolean |
isAttachedToWindow(View view) 如果提供的视图当前附加到窗口,则返回true。 |
static boolean |
isInLayout(View view) 返回视图层次结构当前是否正在进行布局传递。 |
static boolean |
isLaidOut(View view) 如果 |
static boolean |
isLayoutDirectionResolved(View view) 返回布局方向是否已解析。 |
static boolean |
isNestedScrollingEnabled(View view) 如果对此视图启用嵌套滚动,则返回true。 |
static boolean |
isOpaque(View view) 指示此视图是否不透明。 |
static boolean |
isPaddingRelative(View view) 如果通过相对值 |
static void |
jumpDrawablesToCurrentState(View v) 在API 11及更高版本的设备上,请在与此视图关联的所有可绘制对象上调用 |
static void |
offsetLeftAndRight(View view, int offset) 按指定的像素数量偏移此视图的水平位置。 |
static void |
offsetTopAndBottom(View view, int offset) 将此视图的垂直位置偏移指定的像素数。 |
static WindowInsetsCompat |
onApplyWindowInsets(View view, WindowInsetsCompat insets) 根据其内部政策,视图应适用 |
static void |
onInitializeAccessibilityEvent(View v, AccessibilityEvent event) 使用有关此视图的信息初始化 |
static void |
onInitializeAccessibilityNodeInfo(View v, AccessibilityNodeInfoCompat info) 用关于此视图的信息初始化 |
static void |
onPopulateAccessibilityEvent(View v, AccessibilityEvent event) 从 |
static boolean |
performAccessibilityAction(View view, int action, Bundle arguments) 在视图上执行指定的辅助功能操作。 |
static void |
postInvalidateOnAnimation(View view, int left, int top, int right, int bottom) 导致指定区域在下一个动画时间步骤失效,通常是下一个显示帧。 |
static void |
postInvalidateOnAnimation(View view) 导致在下一个动画时间步骤发生无效,通常是下一个显示帧。 |
static void |
postOnAnimation(View view, Runnable action) 使Runnable在下一个动画时间步骤上执行。 |
static void |
postOnAnimationDelayed(View view, Runnable action, long delayMillis) 导致Runnable在指定的时间过后,在下一个动画时间步骤执行。 |
static void |
requestApplyInsets(View view) 请求执行 |
static int |
resolveSizeAndState(int size, int measureSpec, int childMeasuredState) 用于协调所需大小和状态的实用程序,以及MeasureSpec强加的约束。 |
static void |
setAccessibilityDelegate(View v, AccessibilityDelegateCompat delegate) 通过组合设置实现可访问性支持的委托(与继承相反)。 |
static void |
setAccessibilityLiveRegion(View view, int mode) 为指定视图设置活动区域模式。 |
static void |
setActivated(View view, boolean activated) 更改此视图的激活状态。 |
static void |
setAlpha(View view, float value) 设置视图的不透明度。 |
static void |
setBackgroundTintList(View view, ColorStateList tintList) 将背景色应用于背景。 |
static void |
setBackgroundTintMode(View view, PorterDuff.Mode mode) 指定用于将 |
static void |
setChildrenDrawingOrderEnabled(ViewGroup viewGroup, boolean enabled) 告诉ViewGroup是否按照方法 |
static void |
setClipBounds(View view, Rect clipBounds) 在该视图上设置矩形区域,视图在绘制时将被裁剪到该区域。 |
static void |
setElevation(View view, float elevation) 设置此视图的基本高程(以像素为单位)。 |
static void |
setFitsSystemWindows(View view, boolean fitSystemWindows) 设置此视图是否应考虑系统屏幕装饰(如状态栏和插入其内容); 即控制是否执行 |
static void |
setHasTransientState(View view, boolean hasTransientState) 设置此视图是否正在跟踪框架应尽可能保留的暂时状态。 |
static void |
setImportantForAccessibility(View view, int mode) 设置如何确定此视图是否对可访问性很重要,即如果它触发辅助功能事件并将其报告给查询屏幕的辅助功能服务。 |
static void |
setLabelFor(View view, int labeledId) 设置给定视图作为可访问性标签的视图的ID。 |
static void |
setLayerPaint(View view, Paint paint) 更新用于当前图层的 |
static void |
setLayerType(View view, int layerType, Paint paint) 指定支持此视图的图层的类型。 |
static void |
setLayoutDirection(View view, int layoutDirection) 为此视图设置布局方向。 |
static void |
setNestedScrollingEnabled(View view, boolean enabled) 启用或禁用此视图的嵌套滚动。 |
static void |
setOnApplyWindowInsetsListener(View v, OnApplyWindowInsetsListener listener) 设置一个 |
static void |
setOverScrollMode(View v, int overScrollMode) 为此视图设置过卷模式。 |
static void |
setPaddingRelative(View view, int start, int top, int end, int bottom) 设置相对填充。 |
static void |
setPivotX(View view, float value) |
static void |
setPivotY(View view, float value) |
static void |
setPointerIcon(View view, PointerIconCompat pointerIcon) 设置当前视图的指针图标。 |
static void |
setRotation(View view, float value) 设置视图围绕枢轴点旋转的角度。 |
static void |
setRotationX(View view, float value) 设置视图通过枢轴点围绕水平轴旋转的角度。 |
static void |
setRotationY(View view, float value) 设置视图围绕通过枢轴点的垂直轴旋转的角度。 |
static void |
setSaveFromParentEnabled(View v, boolean enabled) 控制此视图下的整个层次结构是否会在其父级发生状态保存遍历时保存其状态。 |
static void |
setScaleX(View view, float value) 以视图的未缩放宽度的比例设置视图在x轴周围按比例缩放的量。 |
static void |
setScaleY(View view, float value) 以视图的未缩放宽度的比例设置视图在Y轴周围缩放的量。 |
static void |
setScrollIndicators(View view, int indicators, int mask) 设置由蒙版指定的滚动指示器的状态。 |
static void |
setScrollIndicators(View view, int indicators) 设置所有滚动指示器的状态。 |
static void |
setTransitionName(View view, String transitionName) 设置用于识别转场中的视图的视图的名称。 |
static void |
setTranslationX(View view, float value) 设置此视图相对于其左侧位置的水平位置。 |
static void |
setTranslationY(View view, float value) 设置此视图相对于其顶部位置的垂直位置。 |
static void |
setTranslationZ(View view, float translationZ) 设置此视图相对于其 |
static void |
setX(View view, float value) 设置此视图的视觉x位置(以像素为单位)。 |
static void |
setY(View view, float value) 设置此视图的可视y位置(以像素为单位)。 |
static void |
setZ(View view, float z) 设置此视图的可视z位置,以像素为单位。 |
static boolean |
startNestedScroll(View view, int axes) 沿给定轴开始可嵌套滚动操作。 |
static void |
stopNestedScroll(View view) 停止正在进行的嵌套滚动。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
int ACCESSIBILITY_LIVE_REGION_ASSERTIVE
实时区域模式指定无障碍服务应中断正在进行的语音,以立即通告对此视图的更改。
与 setAccessibilityLiveRegion(View, int)
使用。
常量值:2(0x00000002)
int ACCESSIBILITY_LIVE_REGION_NONE
实时区域模式指定无障碍服务不应该自动通告对此视图的更改。 这是大多数视图的默认实时区域模式。
与 setAccessibilityLiveRegion(View, int)
使用。
常量值:0(0x00000000)
int ACCESSIBILITY_LIVE_REGION_POLITE
活动区域模式指定无障碍服务应该宣布对此视图的更改。
与 setAccessibilityLiveRegion(View, int)
使用。
常数值:1(0x00000001)
int IMPORTANT_FOR_ACCESSIBILITY_AUTO
自动确定视图对可访问性是否重要。
常量值:0(0x00000000)
int IMPORTANT_FOR_ACCESSIBILITY_NO
该视图对可访问性并不重要。
常量值:2(0x00000002)
int IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS
该视图对可访问性来说并不重要,它的任何后代视图也不重要。
常量值:4(0x00000004)
int IMPORTANT_FOR_ACCESSIBILITY_YES
该视图对可访问性非常重要。
常数值:1(0x00000001)
int LAYER_TYPE_HARDWARE
表示该视图具有硬件层。 硬件层由硬件特定纹理(通常是OpenGL硬件上的帧缓冲区对象或FBO)支持,并使视图使用Android的硬件渲染管道渲染,但前提是视图层次结构的硬件加速已打开。 硬件加速关闭时,硬件层的行为与software layers
完全相同。
硬件层对于将特定颜色过滤器和/或混合模式和/或半透明应用于视图及其所有孩子是有用的。
硬件层可用于将复杂的视图树缓存到纹理中,并降低绘制操作的复杂性。 例如,当使用翻译对复杂视图树进行动画处理时,可以使用硬件层来渲染视图树一次。
旋转变换应用于视图时,硬件层也可用于提高渲染质量。 在视图上应用3D变换时,它也可以用来防止潜在的裁剪问题。
常量值:2(0x00000002)
int LAYER_TYPE_NONE
表示该视图没有图层。
常量值:0(0x00000000)
int LAYER_TYPE_SOFTWARE
表示该视图具有软件层。 一个软件层由一个位图支持,并使视图使用Android的软件渲染管道渲染,即使启用了硬件加速。
软件层有各种用途:
当应用程序未使用硬件加速时,软件层对于将特定颜色过滤器和/或混合模式和/或半透明应用于视图及其所有子项很有用。
当应用程序使用硬件加速时,软件层可用于渲染硬件加速管道不支持的绘制原语。 它也可用于将复杂的视图树缓存到纹理中,并降低绘制操作的复杂性。 例如,当使用翻译对复杂视图树进行动画处理时,可以使用软件层仅渲染一次视图树。
受影响的视图树经常更新时应避免软件层。 每次更新都需要重新渲染软件层,这可能会很慢(特别是当硬件加速打开时,因为在每次更新后必须将图层上载到硬件纹理中)。
常数值:1(0x00000001)
int LAYOUT_DIRECTION_INHERIT
该视图的水平布局方向是从其父项继承的。 与setLayoutDirection(View, int)
使用。
常量值:2(0x00000002)
int LAYOUT_DIRECTION_LOCALE
此视图的水平布局方向是从区域设置的默认语言脚本中推导出来的。 与setLayoutDirection(View, int)
使用。
常量值:3(0x00000003)
int LAYOUT_DIRECTION_LTR
此视图的水平布局方向是从左到右。
常量值:0(0x00000000)
int LAYOUT_DIRECTION_RTL
此视图的水平布局方向是从右到左。
常数值:1(0x00000001)
int MEASURED_HEIGHT_STATE_SHIFT
的比特移位 MEASURED_STATE_MASK
去的高度位为宽度和高度结合成单个int功能,例如 getMeasuredState(View)
和的参数的ChildState resolveSizeAndState(int, int, int)
。
常量值:16(0x00000010)
int MEASURED_SIZE_MASK
提供实际测量尺寸的 getMeasuredWidthAndState(View)
和 getMeasuredWidthAndState(View)
位。
常量值:16777215(0x00ffffff)
int MEASURED_STATE_MASK
提供额外状态位的 getMeasuredWidthAndState(View)
和 getMeasuredWidthAndState(View)
位。
常量值:-16777216(0xff000000)
int MEASURED_STATE_TOO_SMALL
getMeasuredWidthAndState(View)
和 getMeasuredWidthAndState(View)
位表示测量的尺寸小于视图所希望的空间。
常量值:16777216(0x01000000)
int OVER_SCROLL_ALWAYS
始终允许用户过度滚动此视图,前提是该视图可以滚动。
常量值:0(0x00000000)
int OVER_SCROLL_IF_CONTENT_SCROLLS
只有当内容足够大时才允许用户过度滚动此视图以便进行有意义的滚动,前提是该视图可以滚动。
常数值:1(0x00000001)
int OVER_SCROLL_NEVER
切勿让用户过度滚动此视图。
常量值:2(0x00000002)
int SCROLL_AXIS_HORIZONTAL
指示沿着水平轴进行滚动。
常数值:1(0x00000001)
int SCROLL_AXIS_NONE
指示没有视图滚动。
常量值:0(0x00000000)
int SCROLL_AXIS_VERTICAL
指示沿着垂直轴进行滚动。
常量值:2(0x00000002)
int SCROLL_INDICATOR_BOTTOM
滚动指示器方向为视图底部边缘。
常量值:2(0x00000002)
int SCROLL_INDICATOR_END
滚动指示器方向为视图的结束边缘。
常量值:32(0x00000020)
int SCROLL_INDICATOR_LEFT
滚动视图左侧边缘的指示器方向。
常量值:4(0x00000004)
int SCROLL_INDICATOR_RIGHT
滚动指示器方向为视图的右边缘。
常量值:8(0x00000008)
int SCROLL_INDICATOR_START
滚动指示器方向为视图的起始边缘。
常量值:16(0x00000010)
int SCROLL_INDICATOR_TOP
滚动指示器的方向为视图的顶部边缘。
常数值:1(0x00000001)
ViewCompat ()
ViewPropertyAnimatorCompat animate (View view)
此方法返回一个ViewPropertyAnimator对象,该对象可用于为此视图上的特定属性设置动画。
在API 14之前,这种方法什么也不做。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
ViewPropertyAnimatorCompat |
ViewPropertyAnimator The ViewPropertyAnimator associated with this View. |
boolean canScrollHorizontally (View v, int direction)
检查此视图是否可以在某个方向上水平滚动。
Parameters | |
---|---|
v |
View : The View against which to invoke the method. |
direction |
int : Negative to check scrolling left, positive to check scrolling right. |
Returns | |
---|---|
boolean |
true if this view can be scrolled in the specified direction, false otherwise. |
boolean canScrollVertically (View v, int direction)
检查该视图是否可以在某个方向上垂直滚动。
Parameters | |
---|---|
v |
View : The View against which to invoke the method. |
direction |
int : Negative to check scrolling up, positive to check scrolling down. |
Returns | |
---|---|
boolean |
true if this view can be scrolled in the specified direction, false otherwise. |
int combineMeasuredStates (int curState, int newState)
合并由 getMeasuredState(View)
返回的两个状态。
Parameters | |
---|---|
curState |
int : The current state as returned from a view or the result of combining multiple views. |
newState |
int : The new view state to combine. |
Returns | |
---|---|
int |
Returns a new integer reflecting the combination of the two states. |
WindowInsetsCompat dispatchApplyWindowInsets (View view, WindowInsetsCompat insets)
请求将给定的窗口插件应用于此视图或其子视图中的其他视图。
该方法应由希望应用与由窗饰或覆盖物遮蔽的区域相对应的插图的客户调用。 这可以包括状态和导航栏,操作栏,输入法等等。 未来可能会添加新的插页类别。 该方法返回所提供的插图,减去由此视图或其子项应用的插入。
Parameters | |
---|---|
view |
View
|
insets |
WindowInsetsCompat : Insets to apply |
Returns | |
---|---|
WindowInsetsCompat |
The provided insets minus the insets that were consumed |
void dispatchFinishTemporaryDetach (View view)
通知其临时分离已结束的观点; 该视图现在被重新附加。
Parameters | |
---|---|
view |
View
|
boolean dispatchNestedFling (View view, float velocityX, float velocityY, boolean consumed)
向嵌套滚动父级派发一个投掷。
应该使用此方法来指示嵌套滚动的孩子已经检测到适用于投掷的适当条件。 通常这意味着触摸滚动以velocity
的滚动方向结束,沿滚动轴达到或超过minimum fling velocity
。
如果嵌套的滚动子视图通常会抛出,但它位于其自己的内容的边缘,则可以使用此方法代替该嵌套的滚动父级。 父母可以有选择地消费一下,或者观察孩子的情绪。
Parameters | |
---|---|
view |
View
|
velocityX |
float : Horizontal fling velocity in pixels per second |
velocityY |
float : Vertical fling velocity in pixels per second |
consumed |
boolean : true if the child consumed the fling, false otherwise |
Returns | |
---|---|
boolean |
true if the nested scrolling parent consumed or otherwise reacted to the fling |
boolean dispatchNestedPreFling (View view, float velocityX, float velocityY)
在此视图处理它之前,将嵌套分派给嵌套的滚动父级。
嵌套的预先掷骰事件是嵌套的掷骰事件,触摸截取是触摸的,嵌套的预滚动是嵌套滚动。 dispatchNestedPreFling
在子视图消耗它之前抵消了嵌套式dispatchNestedPreFling
中的父视图的机会以完全消耗该dispatchNestedPreFling
。 如果此方法返回true
,则嵌套父视图消耗了该块,并且该视图不应该作为结果滚动。
为了获得更好的用户体验,嵌套滚动链中只有一个视图应该一次使用这个文件。 如果父视图消耗了这个方法,这个方法将返回false。 自定义视图实现应该以两种方式解决这个问题:
dispatchNestedPreFling
; consume the fling and settle to a valid position regardless.视图也不应该在当前不支持滚动的坐标轴上为嵌套父视图提供快速速度; 一个ScrollView
不应该向其父母提供水平的ScrollView
速度,因为沿着该轴的滚动是不允许的,并且沿该运动的速度没有意义。
Parameters | |
---|---|
view |
View
|
velocityX |
float : Horizontal fling velocity in pixels per second |
velocityY |
float : Vertical fling velocity in pixels per second |
Returns | |
---|---|
boolean |
true if a nested scrolling parent consumed the fling |
boolean dispatchNestedPreScroll (View view, int dx, int dy, int[] consumed, int[] offsetInWindow)
在该视图消耗其任何部分之前,调度正在进行的嵌套滚动的一个步骤。
嵌套的预滚动事件是嵌套的滚动事件是什么触摸拦截要触摸。 dispatchNestedPreScroll
为嵌套滚动操作中的父视图提供了在子视图消耗它之前消耗部分或全部滚动操作的机会。
Parameters | |
---|---|
view |
View
|
dx |
int : Horizontal scroll distance in pixels |
dy |
int : Vertical scroll distance in pixels |
consumed |
int : Output. If not null, consumed[0] will contain the consumed component of dx and consumed[1] the consumed dy. |
offsetInWindow |
int : Optional. If not null, on return this will contain the offset in local view coordinates of this view from before this operation to after it completes. View implementations may use this to adjust expected input coordinate tracking. |
Returns | |
---|---|
boolean |
true if the parent consumed some or all of the scroll delta |
boolean dispatchNestedScroll (View view, int dxConsumed, int dyConsumed, int dxUnconsumed, int dyUnconsumed, int[] offsetInWindow)
发送正在进行的嵌套滚动的一个步骤。
支持嵌套滚动的视图实现应该调用它来报告正在进行的滚动信息到当前嵌套的滚动父项。 如果嵌套滚动当前没有进行,或者对于该视图嵌套滚动不是enabled
,则此方法不执行任何操作。
在使用滚动事件本身的组件之前,兼容的视图实现也应该调用 dispatchNestedPreScroll
。
Parameters | |
---|---|
view |
View
|
dxConsumed |
int : Horizontal distance in pixels consumed by this view during this scroll step |
dyConsumed |
int : Vertical distance in pixels consumed by this view during this scroll step |
dxUnconsumed |
int : Horizontal scroll distance in pixels not consumed by this view |
dyUnconsumed |
int : Horizontal scroll distance in pixels not consumed by this view |
offsetInWindow |
int : Optional. If not null, on return this will contain the offset in local view coordinates of this view from before this operation to after it completes. View implementations may use this to adjust expected input coordinate tracking. |
Returns | |
---|---|
boolean |
true if the event was dispatched, false if it could not be dispatched. |
void dispatchStartTemporaryDetach (View view)
通知它正被临时分离的观点。
Parameters | |
---|---|
view |
View
|
int getAccessibilityLiveRegion (View view)
获取指定View的实时区域模式。
Parameters | |
---|---|
view |
View : The view from which to obtain the live region mode |
Returns | |
---|---|
int |
The live region mode for the view. |
AccessibilityNodeProviderCompat getAccessibilityNodeProvider (View view)
获取用于管理以此视图为根的虚拟视图层次结构的提供者,并将其报告给探索窗口内容的 AccessibilityService
。
如果此方法返回实例,则此实例负责管理描述以此View为根的虚拟子树的AccessibilityNodeInfoCompat
,其中包括表示View本身的虚拟子树。 同样,返回的实例负责在任何虚拟视图或根视图本身上执行辅助功能操作。
如果 AccessibilityDelegateCompat
已通过调用指定 setAccessibilityDelegate(View, AccessibilityDelegateCompat)
其 getAccessibilityNodeProvider(View)
负责处理此调用。
Parameters | |
---|---|
view |
View : The view whose property to get. |
Returns | |
---|---|
AccessibilityNodeProviderCompat |
The provider. |
float getAlpha (View view)
视图的不透明度。 这是从0到1的值,其中0表示视图完全透明,1表示视图完全不透明。
默认情况下这是1.0f。 在API 11之前,返回值始终为1.0f。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
float |
The opacity of the view. |
ColorStateList getBackgroundTintList (View view)
如果指定,返回应用于背景可绘制的色调。
仅在API v21或更新版本上运行时才返回有意义的信息,或者 view
实现 TintableBackgroundView
接口。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
ColorStateList |
PorterDuff.Mode getBackgroundTintMode (View view)
如果指定,则返回用于将色调应用于背景可绘制的混合模式。
仅在API v21或更新版本上运行时才返回有意义的信息,或者 view
实现 TintableBackgroundView
接口。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
PorterDuff.Mode |
Rect getClipBounds (View view)
返回当前的 setClipBounds(View, Rect)
的副本。
在API 18之前,这将返回null。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
Rect |
A copy of the current clip bounds if clip bounds are set, otherwise null. |
float getElevation (View view)
此视图相对于其父项的基础高程,以像素为单位。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
float |
The base depth position of the view, in pixels. |
boolean getFitsSystemWindows (View v)
如果此视图适应系统窗口插入,则返回true。 在API 16(Jellybean)之前,此方法将始终返回false。
Parameters | |
---|---|
v |
View
|
Returns | |
---|---|
boolean |
int getImportantForAccessibility (View view)
获取用于确定此视图是否对可访问性很重要的模式,即是否触发辅助功能事件并将其报告给查询屏幕的辅助功能服务。
Parameters | |
---|---|
view |
View : The view whose property to get. |
Returns | |
---|---|
int |
The mode for determining whether a View is important for accessibility. |
int getLabelFor (View view)
获取给定视图用作可访问性标签的视图的ID。
Parameters | |
---|---|
view |
View : The view on which to invoke the corresponding method. |
Returns | |
---|---|
int |
The labeled view id. |
int getLayerType (View view)
指示当前与此视图关联的图层类型。 默认情况下,视图没有图层,图层类型为LAYER_TYPE_NONE
。 有关不同类型的图层的更多信息,请参阅文档setLayerType(android.view.View, int, android.graphics.Paint)
。
Parameters | |
---|---|
view |
View : The view to fetch the layer type from |
Returns | |
---|---|
int |
LAYER_TYPE_NONE , LAYER_TYPE_SOFTWARE or LAYER_TYPE_HARDWARE |
int getLayoutDirection (View view)
返回此视图的已解析布局方向。
Parameters | |
---|---|
view |
View : View to get layout direction for |
Returns | |
---|---|
int |
LAYOUT_DIRECTION_RTL if the layout direction is RTL or returns LAYOUT_DIRECTION_LTR if the layout direction is not RTL. For compatibility, this will return LAYOUT_DIRECTION_LTR if API version is lower than Jellybean MR1 (API 17) |
Matrix getMatrix (View view)
该视图的变换矩阵,根据当前的旋转,缩放和透视属性进行计算。
在11之前,此方法将返回 null
。
Parameters | |
---|---|
view |
View : The view whose Matrix will be returned |
Returns | |
---|---|
Matrix |
The current transform matrix for the view |
int getMeasuredHeightAndState (View view)
按照最近致电measure(int, int)
计算结果返回该视图的全高度测量信息。 该结果是由MEASURED_SIZE_MASK
和MEASURED_STATE_TOO_SMALL
定义的位掩码。 这只应在测量和布局计算中使用。 使用getHeight()
查看布局后视图的宽度。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
int |
The measured width of this view as a bit mask. |
int getMeasuredState (View view)
仅返回状态位getMeasuredWidthAndState(View)
和getMeasuredHeightAndState(View)
,合并为一个整数。 宽度分量位于常规位MEASURED_STATE_MASK
,高度分量位于位移位MEASURED_HEIGHT_STATE_SHIFT
>> MEASURED_STATE_MASK
。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
int |
int getMeasuredWidthAndState (View view)
按照最近一次对measure(int, int)
调用计算,返回该视图的全宽度测量信息。 该结果是由MEASURED_SIZE_MASK
和MEASURED_STATE_TOO_SMALL
定义的位掩码。 这只应在测量和布局计算中使用。 使用getWidth()
查看布局后视图的宽度。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
int |
The measured width of this view as a bit mask. |
int getMinimumHeight (View view)
返回视图的最小高度。
在API 16之前,这将返回0。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
int |
the minimum height the view will try to be. |
int getMinimumWidth (View view)
返回视图的最小宽度。
在API 16之前,这将返回0。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
int |
the minimum width the view will try to be. |
int getOverScrollMode (View v)
返回此视图的过卷模式。 结果将是OVER_SCROLL_ALWAYS
(默认), OVER_SCROLL_IF_CONTENT_SCROLLS
(仅当视图内容大于容器时允许过度滚动)或OVER_SCROLL_NEVER
。
Parameters | |
---|---|
v |
View : The View against which to invoke the method. |
Returns | |
---|---|
int |
This view's over-scroll mode. |
int getPaddingEnd (View view)
根据解析后的布局方向返回指定视图的结束填充。 如果有插入和启用滚动条,则此值可能还包括显示滚动条所需的空间。
Parameters | |
---|---|
view |
View : The view to get padding for |
Returns | |
---|---|
int |
the end padding in pixels |
int getPaddingStart (View view)
根据解析后的布局方向返回指定视图的开始填充。 如果有插入和启用滚动条,则此值可能还包括显示滚动条所需的空间。
Parameters | |
---|---|
view |
View : The view to get padding for |
Returns | |
---|---|
int |
the start padding in pixels |
ViewParent getParentForAccessibility (View view)
获取父级的可访问性。 请注意,可访问性的父级不需要直接父级。 这是第一个对可访问性非常重要的前身。
Parameters | |
---|---|
view |
View : View to retrieve parent for |
Returns | |
---|---|
ViewParent |
The parent for use in accessibility inspection |
float getPivotY (View view)
在API 11之前,这将返回0。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
float |
The y location of the pivot point. |
int getScrollIndicators (View view)
返回表示启用的滚动指示符的位掩码。
例如,如果顶部和左侧滚动指示器已启用,并且所有其他指示器都被禁用,则返回值将为 ViewCompat.SCROLL_INDICATOR_TOP | ViewCompat.SCROLL_INDICATOR_LEFT
。
要检查底部滚动指示器是否已启用,请使用值 (ViewCompat.getScrollIndicators(view) & ViewCompat.SCROLL_INDICATOR_BOTTOM) != 0
。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
int |
a bitmask representing the enabled scroll indicators |
String getTransitionName (View view)
返回用于在转换中标识视图的视图的名称。 名称在视图层次结构中应该是唯一的。
如果View没有被赋予名字,则返回null。
Parameters | |
---|---|
view |
View : The View against which to invoke the method. |
Returns | |
---|---|
String |
The name used of the View to be used to identify Views in Transitions or null if no name has been given. |
float getTranslationX (View view)
该视图的水平位置相对于其left
位置。 除了对象的布局放置它之外,此位置是布局后布局。
在API 11之前,这将返回0。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
float |
The horizontal position of this view relative to its left position, in pixels. |
float getTranslationY (View view)
该视图相对于其top
位置的垂直位置。 除了对象的布局放置它之外,此位置是布局后布局。
在API 11之前,这将返回0。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
float |
The vertical position of this view relative to its top position, in pixels. |
float getTranslationZ (View view)
该视图的深度位置相对于其 elevation
。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
float |
The depth of this view relative to its elevation. |
int getWindowSystemUiVisibility (View view)
返回当前为整个窗口设置的系统UI可见性。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
int |
float getZ (View view)
此视图的可视z位置,以像素为单位。 这相当于translationZ
属性加上当前的elevation
属性。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
float |
The visual z position of this view, in pixels. |
boolean hasAccessibilityDelegate (View v)
检查提供的View是否具有附加的可访问性委托。
Parameters | |
---|---|
v |
View : The View instance to check |
Returns | |
---|---|
boolean |
True if the View has an accessibility delegate |
boolean hasNestedScrollingParent (View view)
如果此视图具有嵌套滚动父级,则返回true。
嵌套滚动父项的存在表示该视图已启动嵌套滚动,并且被视图层次结构的更上层的祖先视图接受。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
boolean |
whether this view has a nested scrolling parent |
boolean hasOnClickListeners (View view)
返回提供的视图是否附有 View.OnClickListener
。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
boolean |
true if there is a listener, false if there is none. |
boolean hasOverlappingRendering (View view)
返回此视图是否包含重叠的内容。
打算被特定视图类型覆盖的此函数是在视图上设置alpha时的优化。 如果渲染在alpha <1的视图中重叠,则该视图将被拖到屏幕外的缓冲区,然后合成到位,这可能很昂贵。 如果视图没有重叠的渲染,视图可以直接用适当的alpha值绘制每个基元。 重叠渲染的一个例子是带有背景图像的TextView,例如Button。 非重叠渲染的一个例子是没有背景的TextView或只有前景图像的ImageView。 默认实现返回true; 如果子类有可以优化的情况,子类应该重写。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
boolean |
true if the content in this view might overlap, false otherwise. |
boolean hasTransientState (View view)
指示视图当前是否跟踪暂时状态,即应用程序不需要关心保存和还原,但是框架应该特别注意在可能的情况下保留。
Parameters | |
---|---|
view |
View : View to check for transient state |
Returns | |
---|---|
boolean |
true if the view has transient state |
boolean isAttachedToWindow (View view)
如果提供的视图当前附加到窗口,则返回true。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
boolean |
boolean isInLayout (View view)
返回视图层次结构当前是否正在进行布局传递。 此信息对于避免在布局过程中调用requestLayout()
等情况很有用。
兼容性:
false
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
boolean |
whether the view hierarchy is currently undergoing a layout pass |
boolean isLaidOut (View view)
如果 view
自上次连接到窗口或从窗口分离后至少经历了一次布局,则返回true。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
boolean |
boolean isLayoutDirectionResolved (View view)
返回布局方向是否已解析。
兼容性:
false
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
boolean |
true if layout direction has been resolved. |
boolean isNestedScrollingEnabled (View view)
如果对此视图启用嵌套滚动,则返回true。
如果启用了嵌套滚动并且此View类实现支持它,则该视图将在适用时充当嵌套滚动子视图,将有关正在进行的滚动操作的数据转发给兼容且协作的嵌套滚动父级。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
boolean |
true if nested scrolling is enabled |
boolean isOpaque (View view)
指示此视图是否不透明。 不透明视图保证它将使用完全不透明的颜色绘制所有像素重叠的边界。 在API 7及以上版本中,这将调用View的true isOpaque方法。 在以前的平台版本中,它将检查视图背景的不透明度(如果存在)。
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
boolean |
True if this View is guaranteed to be fully opaque, false otherwise. |
boolean isPaddingRelative (View view)
如果通过相对值 View.setPaddingRelative(int, int, int, int)
或直通填充填充,则返回
Parameters | |
---|---|
view |
View
|
Returns | |
---|---|
boolean |
true if the padding is relative or false if it is not. |
void jumpDrawablesToCurrentState (View v)
在API 11及更高版本的设备上,在与此视图关联的所有可绘制对象上调用 Drawable.jumpToCurrentState()
。
在API 21及更高版本上,如果有一个StateListAnimator附加到此视图,也会调用 StateListAnimator#jumpToCurrentState()
。
Parameters | |
---|---|
v |
View
|
void offsetLeftAndRight (View view, int offset)
按指定的像素数量偏移此视图的水平位置。
Parameters | |
---|---|
view |
View
|
offset |
int : the number of pixels to offset the view by |
void offsetTopAndBottom (View view, int offset)
将此视图的垂直位置偏移指定的像素数。
Parameters | |
---|---|
view |
View
|
offset |
int : the number of pixels to offset the view by |
WindowInsetsCompat onApplyWindowInsets (View view, WindowInsetsCompat insets)
根据其内部政策,视图应适用 WindowInsetsCompat
时调用。
客户可以提供OnApplyWindowInsetsListener
视图。 如果设置了一个,它将在调度过程中被调用,而不是这个方法。 如果监听器希望除了自己的应用外还应用视图的默认插入策略,则可以选择从其自己的实现中调用此方法。
Parameters | |
---|---|
view |
View : The View against which to invoke the method. |
insets |
WindowInsetsCompat : Insets to apply |
Returns | |
---|---|
WindowInsetsCompat |
The supplied insets with any applied insets consumed |
void onInitializeAccessibilityEvent (View v, AccessibilityEvent event)
使用有关此视图的信息初始化AccessibilityEvent
,这是事件源。 换句话说,可访问性事件的来源是其状态改变触发事件触发的视图。
示例:除了由超级实现设置的属性之外,还设置事件的密码属性:
public void onInitializeAccessibilityEvent(AccessibilityEvent event) { super.onInitializeAccessibilityEvent(event); event.setPassword(true); }
如果 AccessibilityDelegateCompat
已通过调用指定 setAccessibilityDelegate(View, AccessibilityDelegateCompat)
,其 onInitializeAccessibilityEvent(View, AccessibilityEvent)
负责处理此调用。
Parameters | |
---|---|
v |
View : The View against which to invoke the method. |
event |
AccessibilityEvent : The event to initialize. |
void onInitializeAccessibilityNodeInfo (View v, AccessibilityNodeInfoCompat info)
使用关于此视图的信息初始化AccessibilityNodeInfoCompat
。 基本实现设置:
setParent(View)
,setBoundsInParent(Rect)
,setBoundsInScreen(Rect)
,setPackageName(CharSequence)
,setClassName(CharSequence)
,setContentDescription(CharSequence)
,setEnabled(boolean)
,setClickable(boolean)
,setFocusable(boolean)
,setFocused(boolean)
,setLongClickable(boolean)
,setSelected(boolean)
,如果 AccessibilityDelegateCompat
已通过调用指定 setAccessibilityDelegate(View, AccessibilityDelegateCompat)
,其 onInitializeAccessibilityNodeInfo(View, AccessibilityNodeInfoCompat)
方法是负责处理此调用。
Parameters | |
---|---|
v |
View : The View against which to invoke the method. |
info |
AccessibilityNodeInfoCompat : The instance to initialize. |
void onPopulateAccessibilityEvent (View v, AccessibilityEvent event)
从dispatchPopulateAccessibilityEvent(AccessibilityEvent)
调用,为此视图提供一个机会,用它的文本内容填充辅助功能事件。 虽然此方法可自由修改文本内容以外的事件属性,但通常应在onInitializeAccessibilityEvent(AccessibilityEvent)
执行onInitializeAccessibilityEvent(AccessibilityEvent)
。
示例:除超级实现添加的文本外,还将格式化的日期字符串添加到辅助功能事件中:
public void onPopulateAccessibilityEvent(AccessibilityEvent event) { super.onPopulateAccessibilityEvent(event); final int flags = DateUtils.FORMAT_SHOW_DATE | DateUtils.FORMAT_SHOW_WEEKDAY; String selectedDateUtterance = DateUtils.formatDateTime(mContext, mCurrentDate.getTimeInMillis(), flags); event.getText().add(selectedDateUtterance); }
如果 AccessibilityDelegateCompat
已通过调用指定 setAccessibilityDelegate(View, AccessibilityDelegateCompat)
其 onPopulateAccessibilityEvent(View, AccessibilityEvent)
负责处理此调用。
注意:在向事件添加信息之前始终调用超级实现,以防缺省实现具有要添加的基本信息。
Parameters | |
---|---|
v |
View : The View against which to invoke the method. |
event |
AccessibilityEvent : The accessibility event which to populate. |
boolean performAccessibilityAction (View view, int action, Bundle arguments)
在视图上执行指定的辅助功能操作。 有关可能的辅助功能操作,请AccessibilityNodeInfoCompat
。
如果 AccessibilityDelegateCompat
已通过调用指定 setAccessibilityDelegate(View, AccessibilityDelegateCompat)
其 performAccessibilityAction(View, int, Bundle)
负责处理此调用。
Parameters | |
---|---|
view |
View
|
action |
int : The action to perform. |
arguments |
Bundle : Optional action arguments. |
Returns | |
---|---|
boolean |
Whether the action was performed. |
void postInvalidateOnAnimation (View view, int left, int top, int right, int bottom)
导致指定区域在下一个动画时间步骤失效,通常是下一个显示帧。
只有当此视图附加到窗口时,才可以从UI线程之外调用此方法。
Parameters | |
---|---|
view |
View : View to invalidate |
left |
int : The left coordinate of the rectangle to invalidate. |
top |
int : The top coordinate of the rectangle to invalidate. |
right |
int : The right coordinate of the rectangle to invalidate. |
bottom |
int : The bottom coordinate of the rectangle to invalidate. |
void postInvalidateOnAnimation (View view)
导致在下一个动画时间步骤发生无效,通常是下一个显示帧。
只有当此视图附加到窗口时,才可以从UI线程之外调用此方法。
Parameters | |
---|---|
view |
View : View to invalidate |
void postOnAnimation (View view, Runnable action)
使Runnable在下一个动画时间步骤上执行。 runnable将在用户界面线程上运行。
只有当此视图附加到窗口时,才可以从UI线程之外调用此方法。
Parameters | |
---|---|
view |
View : View to post this Runnable to |
action |
Runnable : The Runnable that will be executed. |
void postOnAnimationDelayed (View view, Runnable action, long delayMillis)
导致Runnable在指定的时间过后,在下一个动画时间步骤执行。 runnable将在用户界面线程上运行。
只有当此视图附加到窗口时,才可以从UI线程之外调用此方法。
Parameters | |
---|---|
view |
View : The view to post this Runnable to |
action |
Runnable : The Runnable that will be executed. |
delayMillis |
long : The delay (in milliseconds) until the Runnable will be executed. |
void requestApplyInsets (View view)
请求执行View.onApplyWindowInsets(WindowInsets)
的新调度。 这可以回到View.requestFitSystemWindows()
。
Parameters | |
---|---|
view |
View
|
int resolveSizeAndState (int size, int measureSpec, int childMeasuredState)
用于协调所需大小和状态的实用程序,以及MeasureSpec强加的约束。 将采取所需的大小,除非约束施加不同的大小。 返回值是一个复合整数,如果生成的大小小于视图想要的大小,则解析大小在MEASURED_SIZE_MASK
位,并且可选地设置位MEASURED_STATE_TOO_SMALL
。
Parameters | |
---|---|
size |
int : How big the view wants to be |
measureSpec |
int : Constraints imposed by the parent |
childMeasuredState |
int
|
Returns | |
---|---|
int |
Size information bit mask as defined by MEASURED_SIZE_MASK and MEASURED_STATE_TOO_SMALL . |
void setAccessibilityDelegate (View v, AccessibilityDelegateCompat delegate)
通过组合设置实现可访问性支持的委托(与继承相反)。 有关更多详细信息,请参阅AccessibilityDelegateCompat
。
在API 14之前的平台版本中,此方法是无操作的。
注意:在API 23
之前的平台版本上, 在主机方法之前调用android.widget.*
包中视图的android.widget.*
方法。 这可以通过覆盖onInitializeAccessibilityNodeInfo(View, AccessibilityNodeInfoCompat)
防止某些属性(如类名)被修改,因为任何更改都将被主机类所覆盖。
从 API 23
开始, 在主机方法 之后调用委托方法,所有属性都将被修改而不被主机类覆盖。
Parameters | |
---|---|
v |
View
|
delegate |
AccessibilityDelegateCompat : the object to which accessibility method calls should be delegated |
也可以看看:
void setAccessibilityLiveRegion (View view, int mode)
为指定视图设置活动区域模式。 这表明无障碍服务是否应自动通知用户有关视图内容描述或文本的更改,或视图的子项(如果适用)的内容描述或文本。
例如,在具有显示“密码错误”通知的TextView的登录屏幕中,该视图应标记为模式为 ACCESSIBILITY_LIVE_REGION_POLITE
的实时区域。
要为此视图禁用更改通知,请使用ACCESSIBILITY_LIVE_REGION_NONE
。 这是大多数视图的默认实时区域模式。
为了表明应该通知用户更改,请使用 ACCESSIBILITY_LIVE_REGION_POLITE
。
如果视图的更改应中断正在进行的讲话并立即通知用户,请使用 ACCESSIBILITY_LIVE_REGION_ASSERTIVE
。
Parameters | |
---|---|
view |
View : The view on which to set the live region mode |
mode |
int : The live region mode for this view, one of:
|
void setActivated (View view, boolean activated)
更改此视图的激活状态。 视图可以被激活或不被激活。 请注意,激活与选择不同。 选择是一个瞬态属性,表示用户当前正在与之交互的视图(层次结构)。 激活是用户可以将视图移入和移出的较长期状态。
Parameters | |
---|---|
view |
View
|
activated |
boolean : true if the view must be activated, false otherwise |
void setAlpha (View view, float value)
设置视图的不透明度。 这是从0到1的值,其中0表示视图完全透明,1表示视图完全不透明。
请注意,将alpha设置为半透明值(0 <alpha <1)会对性能产生重大影响,尤其是对于大视图。 最好少用短暂地使用alpha属性,就像在淡入淡出的动画中一样。
在API 11之前,这将不起作用。
Parameters | |
---|---|
view |
View
|
value |
float : The opacity of the view. |
void setBackgroundTintList (View view, ColorStateList tintList)
将背景色应用于背景。
这在运行API v21或更新版本时始终会生效。 在API v21之前的平台上运行时,仅当view
实现TintableBackgroundView
接口时才会生效。
Parameters | |
---|---|
view |
View
|
tintList |
ColorStateList
|
void setBackgroundTintMode (View view, PorterDuff.Mode mode)
指定用于将setBackgroundTintList(android.view.View, android.content.res.ColorStateList)
指定的色调应用于背景可绘制的混合模式。 默认模式是SRC_IN
。
这在运行API v21或更新版本时始终会生效。 在API v21之前的平台上运行时,仅当view
实现TintableBackgroundView
接口时才会生效。
Parameters | |
---|---|
view |
View
|
mode |
PorterDuff.Mode
|
void setChildrenDrawingOrderEnabled (ViewGroup viewGroup, boolean enabled)
告诉ViewGroup是否按照方法 ViewGroup.getChildDrawingOrder(int, int)
定义的顺序绘制子 ViewGroup.getChildDrawingOrder(int, int)
。
Parameters | |
---|---|
viewGroup |
ViewGroup
|
enabled |
boolean : true if the order of the children when drawing is determined by getChildDrawingOrder(int, int) , false otherwise 在API 7之前,这将不起作用。 |
void setClipBounds (View view, Rect clipBounds)
在该视图上设置矩形区域,视图在绘制时将被裁剪到该区域。 将该值设置为null将删除剪辑边界,并且视图将使用其全部范围正常绘制。
在API 18之前,这什么都不做。
Parameters | |
---|---|
view |
View : The view to set clipBounds. |
clipBounds |
Rect : The rectangular area, in the local coordinates of this view, to which future drawing operations will be clipped. |
void setElevation (View view, float elevation)
设置此视图的基本高程(以像素为单位)。
Parameters | |
---|---|
view |
View
|
elevation |
float
|
void setFitsSystemWindows (View view, boolean fitSystemWindows)
设置此视图是否应考虑系统屏幕装饰(如状态栏和插入其内容); 即控制是否执行fitSystemWindows(Rect)
的默认实现。 请参阅该方法以获取更多详细信
Parameters | |
---|---|
view |
View
|
fitSystemWindows |
boolean
|
void setHasTransientState (View view, boolean hasTransientState)
设置此视图是否正在跟踪框架应尽可能保留的暂时状态。
Parameters | |
---|---|
view |
View : View tracking transient state |
hasTransientState |
boolean : true if this view has transient state |
void setImportantForAccessibility (View view, int mode)
设置如何确定此视图是否对可访问性很重要,即如果它触发辅助功能事件并将其报告给查询屏幕的辅助功能服务。
注意:如果当前paltform版本不支持 IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS
模式,然后 IMPORTANT_FOR_ACCESSIBILITY_NO
将被使用,因为它是语义的最接近的条款。
Parameters | |
---|---|
view |
View : The view whose property to set. |
mode |
int : How to determine whether this view is important for accessibility. |
void setLabelFor (View view, int labeledId)
设置给定视图作为可访问性标签的视图的ID。
Parameters | |
---|---|
view |
View : The view on which to invoke the corresponding method. |
labeledId |
int : The labeled view id. |
void setLayerPaint (View view, Paint paint)
更新用于当前图层的Paint
对象(仅在当前图层类型未设置为LAYER_TYPE_NONE
)。 下次重绘视图时,将使用提供给setLayerType(android.view.View, int, android.graphics.Paint)
的Paint的更改属性,但必须调用setLayerPaint(android.view.View, android.graphics.Paint)
以确保立即重绘视图。
的层与可选的相关联Paint
实例,其控制层是如何由在屏幕上。 组成图层时考虑以下涂料属性:
如果通过调用View#setAlpha(float)将此视图的alpha值设置为<1.0,则该图层的alpha值将被此视图的alpha值替换。 因此,调用View#setAlpha(float)相当于在该视图上设置一个硬件层,并提供具有所需alpha值的画图。
Parameters | |
---|---|
view |
View : View to set a layer paint for |
paint |
Paint : The paint used to compose the layer. This argument is optional and can be null. It is ignored when the layer type is LAYER_TYPE_NONE |
void setLayerType (View view, int layerType, Paint paint)
指定支持此视图的图层的类型。 该层可以是disabled
, software
或hardware
。
的层与可选的相关联Paint
实例,其控制层是如何由在屏幕上。 组成图层时考虑以下涂料属性:
如果通过调用setAlpha(float)将此视图的alpha值设置为<1.0,则该图层的alpha值将被此视图的alpha值替换。 因此,调用setAlpha(float)相当于在该视图上设置一个硬件层,并提供具有所需alpha值的画图。
请参阅的文件 disabled
, software
和 hardware
有关何时以及如何使用层的更多信息。
Parameters | |
---|---|
view |
View : View to set the layer type for |
layerType |
int : The type of layer to use with this view, must be one of LAYER_TYPE_NONE , LAYER_TYPE_SOFTWARE or LAYER_TYPE_HARDWARE |
paint |
Paint : The paint used to compose the layer. This argument is optional and can be null. It is ignored when the layer type is LAYER_TYPE_NONE |
void setLayoutDirection (View view, int layoutDirection)
为此视图设置布局方向。 这会将布局方向分辨率的重置传播给视图的子节点,并解析该视图的布局方向。
Parameters | |
---|---|
view |
View : View to set layout direction for |
layoutDirection |
int : the layout direction to set. Should be one of: LAYOUT_DIRECTION_LTR , LAYOUT_DIRECTION_RTL , LAYOUT_DIRECTION_INHERIT , LAYOUT_DIRECTION_LOCALE . Resolution will be done if the value is set to LAYOUT_DIRECTION_INHERIT. The resolution proceeds up the parent chain of the view to get the value. If there is no parent, then it will return the default LAYOUT_DIRECTION_LTR . |
void setNestedScrollingEnabled (View view, boolean enabled)
启用或禁用此视图的嵌套滚动。
如果此属性设置为true,则视图将被允许在当前层次结构中使用兼容父视图启动嵌套滚动操作。 如果这个视图没有实现嵌套滚动,这将不起作用。 嵌套滚动正在进行时禁用嵌套滚动具有stopping
嵌套滚动的效果。
Parameters | |
---|---|
view |
View
|
enabled |
boolean : true to enable nested scrolling, false to disable |
void setOnApplyWindowInsetsListener (View v, OnApplyWindowInsetsListener listener)
设置OnApplyWindowInsetsListener
以接管将视窗插入应用于此视图的策略。 这只会在API 21或更高版本的设备上生效。
Parameters | |
---|---|
v |
View
|
listener |
OnApplyWindowInsetsListener
|
void setOverScrollMode (View v, int overScrollMode)
为此视图设置过卷模式。 有效的滚动模式有OVER_SCROLL_ALWAYS
(默认), OVER_SCROLL_IF_CONTENT_SCROLLS
(只允许在视图内容大于容器时滚动滚动)或OVER_SCROLL_NEVER
。 仅当视图能够滚动时才能设置视图的滚动模式。
Parameters | |
---|---|
v |
View : The View against which to invoke the method. |
overScrollMode |
int : The new over-scroll mode for this view. |
void setPaddingRelative (View view, int start, int top, int end, int bottom)
设置相对填充。 该视图可能会添加显示滚动条所需的空间,具体取决于滚动条的样式和可见性。 因此,从数值返回getPaddingStart(View)
, getPaddingTop()
, getPaddingEnd(View)
和getPaddingBottom()
可能与此调用设置的值不同。
Parameters | |
---|---|
view |
View : The view on which to set relative padding |
start |
int : the start padding in pixels |
top |
int : the top padding in pixels |
end |
int : the end padding in pixels |
bottom |
int : the bottom padding in pixels |
void setPivotX (View view, float value)
设置视图为rotated
和scaled
的点的x位置。 默认情况下,枢轴点位于对象的中心。 设置此属性将禁用此行为,并使视图仅使用显式设置的pivotX和pivotY值。
Prior to API 11 this will have no effect.
Parameters | |
---|---|
view |
View
|
value |
float : The x location of the pivot point. |
void setPivotY (View view, float value)
设置视图为rotated
和scaled
的点的y位置。 默认情况下,枢轴点位于对象的中心。 设置此属性将禁用此行为,并使视图仅使用显式设置的pivotX和pivotY值。
在API 11之前,这将不起作用。
Parameters | |
---|---|
view |
View
|
value |
float : The y location of the pivot point. |
void setPointerIcon (View view, PointerIconCompat pointerIcon)
设置当前视图的指针图标。
Parameters | |
---|---|
view |
View
|
pointerIcon |
PointerIconCompat : A PointerIconCompat instance which will be shown when the mouse hovers. |
void setRotation (View view, float value)
设置视图围绕枢轴点旋转的角度。 增加值会导致顺时针旋转。
Prior to API 11 this will have no effect.
Parameters | |
---|---|
view |
View
|
value |
float : The degrees of rotation. |
void setRotationX (View view, float value)
设置视图通过枢轴点围绕水平轴旋转的角度。 从向下看x轴的角度看,增加值导致顺时针旋转。
在API 11之前,这将不起作用。
Parameters | |
---|---|
view |
View
|
value |
float : The degrees of X rotation. |
void setRotationY (View view, float value)
设置视图围绕通过枢轴点的垂直轴旋转的角度。 从向下看y轴的角度看,增加值导致逆时针旋转。
在API 11之前,这将不起作用。
Parameters | |
---|---|
view |
View
|
value |
float : The degrees of Y rotation. |
void setSaveFromParentEnabled (View v, boolean enabled)
控制此视图下的整个层次结构是否会在其父级发生状态保存遍历时保存其状态。
Parameters | |
---|---|
v |
View
|
enabled |
boolean : Set to false to disable state saving, or true (the default) to allow it. |
void setScaleX (View view, float value)
以视图的未缩放宽度的比例设置视图在x轴周围按比例缩放的量。 值1表示不应用缩放。
在API 11之前,这将不起作用。
Parameters | |
---|---|
view |
View
|
value |
float : The scaling factor. |
void setScaleY (View view, float value)
以视图的未缩放宽度的比例设置视图在Y轴周围缩放的量。 值1表示不应用缩放。
在API 11之前,这将不起作用。
Parameters | |
---|---|
view |
View
|
value |
float : The scaling factor. |
void setScrollIndicators (View view, int indicators, int mask)
设置由蒙版指定的滚动指示器的状态。 要一次更改所有滚动指示器,请参阅setScrollIndicators(View, int)
。
当滚动指示器启用时,如果视图可以沿指示器方向滚动,则会显示滚动指示器。
通过传递所需类型的逻辑OR,可以启用或禁用多种指示器类型。 如果指定了多个类型,它们将全部设置为相同的启用状态。
例如,要启用顶部滚动指示器例如: setScrollIndicators
Parameters | |
---|---|
view |
View
|
indicators |
int : the indicator direction, or the logical OR of multiple indicator directions. One or more of:
|
mask |
int
|
void setScrollIndicators (View view, int indicators)
设置所有滚动指示器的状态。
有关使用信息,请参阅 setScrollIndicators(View, int, int)
。
Parameters | |
---|---|
view |
View
|
indicators |
int : a bitmask of indicators that should be enabled, or 0 to disable all indicators |
void setTransitionName (View view, String transitionName)
设置用于识别转场中的视图的视图的名称。 名称在视图层次结构中应该是唯一的。
Parameters | |
---|---|
view |
View : The View against which to invoke the method. |
transitionName |
String : The name of the View to uniquely identify it for Transitions. |
void setTranslationX (View view, float value)
设置此视图相对于其左侧位置的水平位置。 除了对象的布局放置它之外,这还可以有效地定位对象后布局。
在API 11之前,这将不起作用。
Parameters | |
---|---|
view |
View
|
value |
float : The horizontal position of this view relative to its left position, in pixels. |
void setTranslationY (View view, float value)
设置此视图相对于其顶部位置的垂直位置。 除了对象的布局放置它之外,这还可以有效地定位对象后布局。
在API 11之前,这将不起作用。
Parameters | |
---|---|
view |
View
|
value |
float : The vertical position of this view relative to its top position, in pixels. |
void setTranslationZ (View view, float translationZ)
设置此视图相对于其 elevation
的深度位置。
Parameters | |
---|---|
view |
View
|
translationZ |
float
|
void setX (View view, float value)
设置此视图的视觉x位置(以像素为单位)。 这相当于将translationX
属性设置为translationX
的x值与视图的当前左侧属性(由布局边界确定)之间的差异。
Prior to API 11 this will have no effect.
Parameters | |
---|---|
view |
View
|
value |
float : The visual x position of this view, in pixels. |
void setY (View view, float value)
设置此视图的可视y位置(以像素为单位)。 这相当于将translationY
属性设置为translationY
的y值与由布局边界确定的视图的当前顶部属性之间的差异。
在API 11之前,这将不起作用。
Parameters | |
---|---|
view |
View
|
value |
float : The visual y position of this view, in pixels. |
void setZ (View view, float z)
设置此视图的可视z位置,以像素为单位。 这相当于将translationZ
属性设置为translationZ
的x值与当前的elevation
属性之间的差异。
兼容性:
Parameters | |
---|---|
view |
View
|
z |
float : The visual z position of this view, in pixels. |
boolean startNestedScroll (View view, int axes)
沿给定轴开始可嵌套滚动操作。
开始嵌套滚动的视图承诺遵守以下合同:
该视图将在启动滚动操作时调用startNestedScroll。 在触摸滚动的情况下,这对应于最初的ACTION_DOWN
。 在触摸滚动的情况下,嵌套滚动将以与requestDisallowInterceptTouchEvent(boolean)
相同的方式自动终止。 在编程滚动的情况下,调用者必须显式调用stopNestedScroll(View)
来指示嵌套滚动的结束。
如果startNestedScroll
返回true,则找到合作父项。 如果返回false,则在下一次滚动之前,调用方可能会忽略此合约的其余部分。 当嵌套滚动正在进行时调用startNestedScroll将返回true。
在滚动的每个增量步骤中,一旦计算出所请求的滚动增量,调用者就应该调用dispatchNestedPreScroll
。 如果它返回true,则嵌套滚动父级至少部分消耗滚动,并且调用者应该调整它滚动的数量。
在应用剩余的滚动增量之后,调用者应该调用dispatchNestedScroll
,同时传递消耗的delta和未消耗的delta。 嵌套的滚动父级可能会以不同的方式处理这些值。 见onNestedScroll(View, int, int, int, int)
。
Parameters | |
---|---|
view |
View
|
axes |
int : Flags consisting of a combination of SCROLL_AXIS_HORIZONTAL and/or SCROLL_AXIS_VERTICAL . |
Returns | |
---|---|
boolean |
true if a cooperative parent was found and nested scrolling has been enabled for the current gesture. |
void stopNestedScroll (View view)
停止正在进行的嵌套滚动。
当嵌套滚动当前不在进行中时调用此方法是无害的。
Parameters | |
---|---|
view |
View
|
也可以看看: