ViewCompat

public static final int ACCESSIBILITY_LIVE_REGION_ASSERTIVE = 2

Live region mode specifying that accessibility services should interrupt ongoing speech to immediately announce changes to this view.

Use with setAccessibilityLiveRegion.

public static final int ACCESSIBILITY_LIVE_REGION_NONE = 0

Live region mode specifying that accessibility services should not automatically announce changes to this view. This is the default live region mode for most views.

Use with setAccessibilityLiveRegion.

public static final int ACCESSIBILITY_LIVE_REGION_POLITE = 1

Live region mode specifying that accessibility services should announce changes to this view.

Use with setAccessibilityLiveRegion.

public static final int IMPORTANT_FOR_ACCESSIBILITY_AUTO = 0

Automatically determine whether a view is important for accessibility.

public static final int IMPORTANT_FOR_ACCESSIBILITY_NO = 2

The view is not important for accessibility.

public static final int IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS = 4

The view is not important for accessibility, nor are any of its descendant views.

public static final int IMPORTANT_FOR_ACCESSIBILITY_YES = 1

The view is important for accessibility.

public static final int IMPORTANT_FOR_CONTENT_CAPTURE_AUTO = 0

Automatically determine whether a view is important for content capture.

public static final int IMPORTANT_FOR_CONTENT_CAPTURE_NO = 2

The view is not important for content capture, but its children (if any) will be traversed.

public static final int IMPORTANT_FOR_CONTENT_CAPTURE_NO_EXCLUDE_DESCENDANTS = 8

The view is not important for content capture, and its children (if any) will not be traversed.

public static final int IMPORTANT_FOR_CONTENT_CAPTURE_YES = 1

The view is important for content capture, and its children (if any) will be traversed.

public static final int IMPORTANT_FOR_CONTENT_CAPTURE_YES_EXCLUDE_DESCENDANTS = 4

The view is important for content capture, but its children (if any) will not be traversed.

public static final int LAYER_TYPE_HARDWARE = 2

Indicates that the view has a hardware layer. A hardware layer is backed by a hardware specific texture (generally Frame Buffer Objects or FBO on OpenGL hardware) and causes the view to be rendered using Android's hardware rendering pipeline, but only if hardware acceleration is turned on for the view hierarchy. When hardware acceleration is turned off, hardware layers behave exactly as software layers.

A hardware layer is useful to apply a specific color filter and/or blending mode and/or translucency to a view and all its children.

A hardware layer can be used to cache a complex view tree into a texture and reduce the complexity of drawing operations. For instance, when animating a complex view tree with a translation, a hardware layer can be used to render the view tree only once.

A hardware layer can also be used to increase the rendering quality when rotation transformations are applied on a view. It can also be used to prevent potential clipping issues when applying 3D transforms on a view.

public static final int LAYER_TYPE_NONE = 0

Indicates that the view does not have a layer.

public static final int LAYER_TYPE_SOFTWARE = 1

Indicates that the view has a software layer. A software layer is backed by a bitmap and causes the view to be rendered using Android's software rendering pipeline, even if hardware acceleration is enabled.

Software layers have various usages:

When the application is not using hardware acceleration, a software layer is useful to apply a specific color filter and/or blending mode and/or translucency to a view and all its children.

When the application is using hardware acceleration, a software layer is useful to render drawing primitives not supported by the hardware accelerated pipeline. It can also be used to cache a complex view tree into a texture and reduce the complexity of drawing operations. For instance, when animating a complex view tree with a translation, a software layer can be used to render the view tree only once.

Software layers should be avoided when the affected view tree updates often. Every update will require to re-render the software layer, which can potentially be slow (particularly when hardware acceleration is turned on since the layer will have to be uploaded into a hardware texture after every update.)

public static final int LAYOUT_DIRECTION_INHERIT = 2

Horizontal layout direction of this view is inherited from its parent. Use with setLayoutDirection.

public static final int LAYOUT_DIRECTION_LOCALE = 3

Horizontal layout direction of this view is from deduced from the default language script for the locale. Use with setLayoutDirection.

public static final int LAYOUT_DIRECTION_LTR = 0

Horizontal layout direction of this view is from Left to Right.

public static final int LAYOUT_DIRECTION_RTL = 1

Horizontal layout direction of this view is from Right to Left.

public static final int MEASURED_HEIGHT_STATE_SHIFT = 16

Bit shift of MEASURED_STATE_MASK to get to the height bits for functions that combine both width and height into a single int, such as getMeasuredState and the childState argument of resolveSizeAndState.

public static final int MEASURED_SIZE_MASK = 16777215

Bits of getMeasuredWidthAndState and getMeasuredWidthAndState that provide the actual measured size.

public static final int MEASURED_STATE_MASK = -16777216

Bits of getMeasuredWidthAndState and getMeasuredWidthAndState that provide the additional state bits.

public static final int MEASURED_STATE_TOO_SMALL = 16777216

Bit of getMeasuredWidthAndState and getMeasuredWidthAndState that indicates the measured size is smaller that the space the view would like to have.

public static final int OVER_SCROLL_ALWAYS = 0

Always allow a user to over-scroll this view, provided it is a view that can scroll.

public static final int OVER_SCROLL_IF_CONTENT_SCROLLS = 1

Allow a user to over-scroll this view only if the content is large enough to meaningfully scroll, provided it is a view that can scroll.

public static final int OVER_SCROLL_NEVER = 2

Never allow a user to over-scroll this view.

public static final int SCROLL_AXIS_HORIZONTAL = 1

Indicates scrolling along the horizontal axis.

public static final int SCROLL_AXIS_NONE = 0

Indicates no axis of view scrolling.

public static final int SCROLL_AXIS_VERTICAL = 2

Indicates scrolling along the vertical axis.

public static final int SCROLL_INDICATOR_BOTTOM = 2

Scroll indicator direction for the bottom edge of the view.

public static final int SCROLL_INDICATOR_END = 32

Scroll indicator direction for the ending edge of the view.

public static final int SCROLL_INDICATOR_LEFT = 4

Scroll indicator direction for the left edge of the view.

public static final int SCROLL_INDICATOR_RIGHT = 8

Scroll indicator direction for the right edge of the view.

public static final int SCROLL_INDICATOR_START = 16

Scroll indicator direction for the starting edge of the view.

public static final int SCROLL_INDICATOR_TOP = 1

Scroll indicator direction for the top edge of the view.

public static final int TYPE_NON_TOUCH = 1

Indicates that the input type for the gesture is caused by something which is not a user touching a screen. This is usually from a fling which is settling.

public static final int TYPE_TOUCH = 0

Indicates that the input type for the gesture is from a user touching the screen.

public static int addAccessibilityAction(
    @NonNull View view,
    @NonNull CharSequence label,
    @NonNull AccessibilityViewCommand command
)

Adds an accessibility action that can be performed on a node associated with a view. A view can only have 32 actions created with this API.

public static void addKeyboardNavigationClusters(
    @NonNull View view,
    @NonNull Collection<View> views,
    int direction
)

Adds any keyboard navigation cluster roots that are descendants of view ( including view if it is a cluster root itself) to views. Does nothing on API <26.

public static void addOnUnhandledKeyEventListener(
    @NonNull View view,
    @NonNull ViewCompat.OnUnhandledKeyEventListenerCompat listener
)

Adds a listener which will receive unhandled KeyEvents. This must be called on the UI thread.

public static void addOverlayView(@NonNull ViewGroup overlayHost, @NonNull View overlay)

Convenience method to add overlay to overlayHost's overlay and assign the disjointParent in the overlay hierarchy.

public static @NonNull ViewPropertyAnimatorCompat animate(@NonNull View view)

This method returns a ViewPropertyAnimator object, which can be used to animate specific properties on this View.

@ReplaceWith(expression = "view.canScrollHorizontally(direction)")
public static boolean canScrollHorizontally(View view, int direction)

Check if this view can be scrolled horizontally in a certain direction.

@ReplaceWith(expression = "view.canScrollVertically(direction)")
public static boolean canScrollVertically(View view, int direction)

Check if this view can be scrolled vertically in a certain direction.

public static void cancelDragAndDrop(@NonNull View v)

Cancel the drag and drop operation.

public static int combineMeasuredStates(int curState, int newState)

Merge two states as returned by getMeasuredState.

public static @NonNull WindowInsetsCompat computeSystemWindowInsets(
    @NonNull View view,
    @NonNull WindowInsetsCompat insets,
    @NonNull Rect outLocalInsets
)

Compute insets that should be consumed by this view and the ones that should propagate to those under it.

public static @NonNull WindowInsetsCompat dispatchApplyWindowInsets(
    @NonNull View view,
    @NonNull WindowInsetsCompat insets
)

Request to apply the given window insets to this view or another view in its subtree.

This method should be called by clients wishing to apply insets corresponding to areas obscured by window decorations or overlays. This can include the status and navigation bars, action bars, input methods and more. New inset categories may be added in the future. The method returns the insets provided minus any that were applied by this view or its children.

public static void dispatchFinishTemporaryDetach(@NonNull View view)

Notify a view that its temporary detach has ended; the view is now reattached.

public static boolean dispatchNestedFling(
    @NonNull View view,
    float velocityX,
    float velocityY,
    boolean consumed
)

Dispatch a fling to a nested scrolling parent.

This method should be used to indicate that a nested scrolling child has detected suitable conditions for a fling. Generally this means that a touch scroll has ended with a velocity in the direction of scrolling that meets or exceeds the minimum fling velocity along a scrollable axis.

If a nested scrolling child view would normally fling but it is at the edge of its own content, it can use this method to delegate the fling to its nested scrolling parent instead. The parent may optionally consume the fling or observe a child fling.

public static boolean dispatchNestedPreFling(
    @NonNull View view,
    float velocityX,
    float velocityY
)

Dispatch a fling to a nested scrolling parent before it is processed by this view.

Nested pre-fling events are to nested fling events what touch intercept is to touch and what nested pre-scroll is to nested scroll. dispatchNestedPreFling offsets an opportunity for the parent view in a nested fling to fully consume the fling before the child view consumes it. If this method returns true, a nested parent view consumed the fling and this view should not scroll as a result.

For a better user experience, only one view in a nested scrolling chain should consume the fling at a time. If a parent view consumed the fling this method will return false. Custom view implementations should account for this in two ways:

• If a custom view is paged and needs to settle to a fixed page-point, do not call dispatchNestedPreFling; consume the fling and settle to a valid position regardless.
• If a nested parent does consume the fling, this view should not scroll at all, even to settle back to a valid idle position.

Views should also not offer fling velocities to nested parent views along an axis where scrolling is not currently supported; a ScrollView should not offer a horizontal fling velocity to its parents since scrolling along that axis is not permitted and carrying velocity along that motion does not make sense.

public static boolean dispatchNestedPreScroll(
    @NonNull View view,
    int dx,
    int dy,
    @Nullable int[] consumed,
    @Nullable int[] offsetInWindow
)

Dispatch one step of a nested scroll in progress before this view consumes any portion of it.

This version of the method just calls dispatchNestedPreScroll using the touch input type.

public static boolean dispatchNestedPreScroll(
    @NonNull View view,
    int dx,
    int dy,
    @Nullable int[] consumed,
    @Nullable int[] offsetInWindow,
    int type
)

Dispatch one step of a nested scroll in progress before this view consumes any portion of it.

Nested pre-scroll events are to nested scroll events what touch intercept is to touch. dispatchNestedPreScroll offers an opportunity for the parent view in a nested scrolling operation to consume some or all of the scroll operation before the child view consumes it.

public static boolean dispatchNestedScroll(
    @NonNull View view,
    int dxConsumed,
    int dyConsumed,
    int dxUnconsumed,
    int dyUnconsumed,
    @Nullable int[] offsetInWindow
)

Dispatch one step of a nested scroll in progress.

This version of the method just calls dispatchNestedScroll using the touch input type.

public static boolean dispatchNestedScroll(
    @NonNull View view,
    int dxConsumed,
    int dyConsumed,
    int dxUnconsumed,
    int dyUnconsumed,
    @Nullable int[] offsetInWindow,
    int type
)

Dispatch one step of a nested scroll in progress.

Implementations of views that support nested scrolling should call this to report info about a scroll in progress to the current nested scrolling parent. If a nested scroll is not currently in progress or nested scrolling is not enabled for this view this method does nothing.

Compatible View implementations should also call dispatchNestedPreScroll before consuming a component of the scroll event themselves.

public static void dispatchNestedScroll(
    @NonNull View view,
    int dxConsumed,
    int dyConsumed,
    int dxUnconsumed,
    int dyUnconsumed,
    @Nullable int[] offsetInWindow,
    int type,
    @NonNull int[] consumed
)

Dispatch one step of a nested scroll in progress.

Implementations of views that support nested scrolling should call this to report info about a scroll in progress to the current nested scrolling parent. If a nested scroll is not currently in progress or nested scrolling is not enabled for this view this method does nothing.

Compatible View implementations should also call dispatchNestedPreScroll before consuming a component of the scroll event themselves.

A non-null consumed int array of length 2 may be passed in to enable nested scrolling parents to report how much of the scroll distance was consumed. The original caller (where the input event was received to start the scroll) should initialize the values to be 0, in order to tell how much was actually consumed up the hierarchy of scrolling parents.

public static void dispatchStartTemporaryDetach(@NonNull View view)

Notify a view that it is being temporarily detached.

public static void enableAccessibleClickableSpanSupport(@NonNull View view)

Allow accessibility services to find and activate clickable spans in the application.

android.text.style.ClickableSpan is automatically supported from API 26. For compatibility back to API 19, this should be enabled.

android.text.style.URLSpan, a subclass of ClickableSpans, is automatically supported and does not need this enabled.

Do not put ClickableSpans in setContentDescription or setStateDescription. These links are only visible to accessibility services in getText, which should be modifiable using helper methods on UI elements. For example, use setText to modify the text of TextViews.

public static int generateViewId()

Generate a value suitable for use in setId. This value will not collide with ID values generated at build time by aapt for R.id.

public static @Nullable AccessibilityDelegateCompat getAccessibilityDelegate(@NonNull View view)

Get the current accessibility delegate.

@ReplaceWith(expression = "view.getAccessibilityLiveRegion()")
public static int getAccessibilityLiveRegion(@NonNull View view)

Gets the live region mode for the specified View.

public static @Nullable AccessibilityNodeProviderCompat getAccessibilityNodeProvider(@NonNull View view)

Gets the provider for managing a virtual view hierarchy rooted at this View and reported to android.accessibilityservice.AccessibilityServices that explore the window content.

If this method returns an instance, this instance is responsible for managing AccessibilityNodeInfoCompats describing the virtual sub-tree rooted at this View including the one representing the View itself. Similarly the returned instance is responsible for performing accessibility actions on any virtual view or the root view itself.

If an AccessibilityDelegateCompat has been specified via calling setAccessibilityDelegate its getAccessibilityNodeProvider is responsible for handling this call.

@UiThread
public static @Nullable CharSequence getAccessibilityPaneTitle(@NonNull View view)

Get the title of the pane for purposes of accessibility.

@ReplaceWith(expression = "view.getAlpha()")
public static float getAlpha(View view)

The opacity of the view. This is a value from 0 to 1, where 0 means the view is completely transparent and 1 means the view is completely opaque.

By default this is 1.0f.

public static @Nullable AutofillIdCompat getAutofillId(@NonNull View v)

Gets the unique, logical identifier of this view in the activity, for autofill purposes.

The autofill id is created on demand, unless it is explicitly set by setAutofillId.

See setAutofillId for more info. Compatibility behavior:

• SDK 26 and above, this method matches platform behavior.
• SDK 25 and below, this method always return null.

public static @Nullable ColorStateList getBackgroundTintList(@NonNull View view)

Return the tint applied to the background drawable, if specified.

Only returns meaningful info when running on API v21 or newer, or if view implements the TintableBackgroundView interface.

public static @Nullable PorterDuff.Mode getBackgroundTintMode(@NonNull View view)

Return the blending mode used to apply the tint to the background drawable, if specified.

Only returns meaningful info when running on API v21 or newer, or if view implements the TintableBackgroundView interface.

@ReplaceWith(expression = "view.getClipBounds()")
public static @Nullable Rect getClipBounds(@NonNull View view)

Returns a copy of the current setClipBounds.

Prior to API 18 this will return null.

public static @Nullable ContentCaptureSessionCompat getContentCaptureSession(@NonNull View v)

Gets the session used to notify content capture events. Compatibility behavior:

• SDK 29 and above, this method matches platform behavior.
• SDK 28 and below, this method always return null.

@ReplaceWith(expression = "view.getDisplay()")
public static @Nullable Display getDisplay(@NonNull View view)

Gets the logical display to which the view's window has been attached.

Compatibility:

• API <17: Returns the default display when the view is attached. Otherwise, null.

public static float getElevation(@NonNull View view)

The base elevation of this view relative to its parent, in pixels.

@ReplaceWith(expression = "view.getFitsSystemWindows()")
public static boolean getFitsSystemWindows(@NonNull View view)

Returns true if this view should adapt to fit system window insets. This method will always return false before API 16 (Jellybean).

@ReplaceWith(expression = "view.getImportantForAccessibility()")
public static int getImportantForAccessibility(@NonNull View view)

Gets the mode for determining whether this View is important for accessibility which is if it fires accessibility events and if it is reported to accessibility services that query the screen.

public static int getImportantForAutofill(@NonNull View v)

Gets the mode for determining whether this view is important for autofill.

See setImportantForAutofill and isImportantForAutofill for more info about this mode.

This method is only supported on API >= 26. On API 25 and below, it will always return IMPORTANT_FOR_AUTOFILL_AUTO.

public static int getImportantForContentCapture(@NonNull View v)

Gets the mode for determining whether this view is important for content capture.

See setImportantForContentCapture and isImportantForContentCapture for more info about this mode. Compatibility behavior:

• SDK 30 and above, this method matches platform behavior.
• SDK 29 and below, this method always return IMPORTANT_FOR_CONTENT_CAPTURE_AUTO.

ref android.R.styleable#View_importantForContentCapture

@ReplaceWith(expression = "view.getLabelFor()")
public static int getLabelFor(@NonNull View view)

Gets the id of a view for which a given view serves as a label for accessibility purposes.

@ReplaceWith(expression = "view.getLayerType()")
public static int getLayerType(View view)

Indicates what type of layer is currently associated with this view. By default a view does not have a layer, and the layer type is LAYER_TYPE_NONE. Refer to the documentation of setLayerType for more information on the different types of layers.

@ReplaceWith(expression = "view.getLayoutDirection()")
public static int getLayoutDirection(@NonNull View view)

Returns the resolved layout direction for this view.

@ReplaceWith(expression = "view.getMatrix()")
public static @Nullable Matrix getMatrix(View view)

The transform matrix of this view, which is calculated based on the current rotation, scale, and pivot properties.

@ReplaceWith(expression = "view.getMeasuredHeightAndState()")
public static int getMeasuredHeightAndState(View view)

Return the full height measurement information for this view as computed by the most recent call to measure. This result is a bit mask as defined by MEASURED_SIZE_MASK and MEASURED_STATE_TOO_SMALL. This should be used during measurement and layout calculations only. Use getHeight to see how wide a view is after layout.

@ReplaceWith(expression = "view.getMeasuredState()")
public static int getMeasuredState(View view)

Return only the state bits of getMeasuredWidthAndState and getMeasuredHeightAndState, combined into one integer. The width component is in the regular bits MEASURED_STATE_MASK and the height component is at the shifted bits MEASURED_HEIGHT_STATE_SHIFT>>MEASURED_STATE_MASK.

@ReplaceWith(expression = "view.getMeasuredWidthAndState()")
public static int getMeasuredWidthAndState(View view)

Return the full width measurement information for this view as computed by the most recent call to measure. This result is a bit mask as defined by MEASURED_SIZE_MASK and MEASURED_STATE_TOO_SMALL. This should be used during measurement and layout calculations only. Use getWidth to see how wide a view is after layout.

@ReplaceWith(expression = "view.getMinimumHeight()")
public static int getMinimumHeight(@NonNull View view)

Returns the minimum height of the view.

Prior to API 16, this method may return 0 on some platforms.

@ReplaceWith(expression = "view.getMinimumWidth()")
public static int getMinimumWidth(@NonNull View view)

Returns the minimum width of the view.

Prior to API 16, this method may return 0 on some platforms.

public static int getNextClusterForwardId(@NonNull View view)

Gets the ID of the next keyboard navigation cluster root.

public static @Nullable String[] getOnReceiveContentMimeTypes(@NonNull View view)

Returns the MIME types accepted by the listener configured on the given view via setOnReceiveContentListener. By default returns null.

Different features (e.g. pasting from the clipboard, inserting stickers from the soft keyboard, etc) may optionally use this metadata to conditionally alter their behavior. For example, a soft keyboard may choose to hide its UI for inserting GIFs for a particular input field if the MIME types returned here for that field don't include "image/gif" or "image/*".

Note: Comparisons of MIME types should be performed using utilities such as compareMimeTypes rather than simple string equality, in order to correctly handle patterns such as "text/*", "image/*", etc. Note that MIME type matching in the Android framework is case-sensitive, unlike formal RFC MIME types. As a result, you should always write your MIME types with lowercase letters, or use normalizeMimeType to ensure that it is converted to lowercase.

@ReplaceWith(expression = "view.getOverScrollMode()")
public static int getOverScrollMode(View view)

Returns the over-scroll mode for this view. The result will be one of OVER_SCROLL_ALWAYS (default), OVER_SCROLL_IF_CONTENT_SCROLLS (allow over-scrolling only if the view content is larger than the container), or OVER_SCROLL_NEVER.

@ReplaceWith(expression = "view.getPaddingEnd()")
public static @Px int getPaddingEnd(@NonNull View view)

Returns the end padding of the specified view depending on its resolved layout direction. If there are inset and enabled scrollbars, this value may include the space required to display the scrollbars as well.

@ReplaceWith(expression = "view.getPaddingStart()")
public static @Px int getPaddingStart(@NonNull View view)

Returns the start padding of the specified view depending on its resolved layout direction. If there are inset and enabled scrollbars, this value may include the space required to display the scrollbars as well.

@ReplaceWith(expression = "view.getParentForAccessibility()")
public static @Nullable ViewParent getParentForAccessibility(@NonNull View view)

Gets the parent for accessibility purposes. Note that the parent for accessibility is not necessary the immediate parent. It is the first predecessor that is important for accessibility.

@ReplaceWith(expression = "view.getPivotX()")
public static float getPivotX(View view)

The x location of the point around which the view is rotated and scaled.

@ReplaceWith(expression = "view.getPivotY()")
public static float getPivotY(View view)

The y location of the point around which the view is rotated and scaled.

public static @Nullable WindowInsetsCompat getRootWindowInsets(@NonNull View view)

Provide original WindowInsetsCompat that are dispatched to the view hierarchy. The insets are only available if the view is attached.

On devices running API 20 and below, this method always returns null.

public static int getScrollIndicators(@NonNull View view)

Returns a bitmask representing the enabled scroll indicators.

For example, if the top and left scroll indicators are enabled and all other indicators are disabled, the return value will be ViewCompat.SCROLL_INDICATOR_TOP | ViewCompat.SCROLL_INDICATOR_LEFT.

To check whether the bottom scroll indicator is enabled, use the value of (ViewCompat.getScrollIndicators(view) & ViewCompat.SCROLL_INDICATOR_BOTTOM) != 0.

@UiThread
public static @Nullable CharSequence getStateDescription(@NonNull View view)

Returns the View's state description.

Note: Do not override this method, as it will have no effect on the state description presented to accessibility services. You must call setStateDescription to modify the state description.

public static @NonNull List<Rect> getSystemGestureExclusionRects(@NonNull View view)

Retrieve the list of areas within this view's post-layout coordinate space where the system should not intercept touch or other pointing device gestures.

On devices running API 28 and below, this method always returns an empty list.

public static @Nullable String getTransitionName(@NonNull View view)

Returns the name of the View to be used to identify Views in Transitions. Names should be unique in the View hierarchy.

This returns null if the View has not been given a name.

@ReplaceWith(expression = "view.getTranslationX()")
public static float getTranslationX(View view)

The horizontal location of this view relative to its left position. This position is post-layout, in addition to wherever the object's layout placed it.