AppCompatImageButton | API reference | Android Developers

AppCompatImageButton

Added in 1.1.0

Kotlin |Java

public class AppCompatImageButton extends ImageButton implements TintableBackgroundView

Known direct subclasses

ImageFilterButton

ImageFilterButton

An AppCompatImageButton that can display, combine and filter images.

A ImageButton which supports compatible features on older versions of the platform, including:

Allows dynamic tint of its background via the background tint methods in androidx.core.view.ViewCompat.
Allows setting of the background tint using backgroundTint and backgroundTintMode.
Allows dynamic tint of its image via the image tint methods in ImageViewCompat.
Allows setting of the image tint using tint and tintMode.

This will automatically be used when you use ImageButton in your layouts and the top-level activity / dialog is provided by appcompat. You should only need to manually use this class when writing custom views.

Summary

Public constructors
`AppCompatImageButton(@NonNull Context context)`
`AppCompatImageButton( @NonNull Context context, @Nullable AttributeSet attrs )`
`AppCompatImageButton( @NonNull Context context, @Nullable AttributeSet attrs, int defStyleAttr )`

Public methods
`boolean`	`hasOverlappingRendering()`
`void`	`setBackgroundDrawable(@Nullable Drawable background)` This method is deprecated.
`void`	`setBackgroundResource(@DrawableRes int resId)`
`void`	`setImageBitmap(Bitmap bm)`
`void`	`setImageDrawable(@Nullable Drawable drawable)`
`void`	`setImageLevel(int level)`
`void`	`setImageResource(@DrawableRes int resId)`
`void`	`setImageURI(@Nullable Uri uri)`

Protected methods
`void`	`drawableStateChanged()`

Inherited Constants

From android.view.View

`static final int`	`ACCESSIBILITY_DATA_SENSITIVE_AUTO = 0`
`static final int`	`ACCESSIBILITY_DATA_SENSITIVE_NO = 2`
`static final int`	`ACCESSIBILITY_DATA_SENSITIVE_YES = 1`
`static final int`	`ACCESSIBILITY_LIVE_REGION_ASSERTIVE = 2`
`static final int`	`ACCESSIBILITY_LIVE_REGION_NONE = 0`
`static final int`	`ACCESSIBILITY_LIVE_REGION_POLITE = 1`
`static final Property<View, Float>`	`ALPHA`
`static final int`	`AUTOFILL_FLAG_INCLUDE_NOT_IMPORTANT_VIEWS = 1`
`static final String`	`AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_DATE = "creditCardExpirationDate"`
`static final String`	`AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_DAY = "creditCardExpirationDay"`
`static final String`	`AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_MONTH = "creditCardExpirationMonth"`
`static final String`	`AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_YEAR = "creditCardExpirationYear"`
`static final String`	`AUTOFILL_HINT_CREDIT_CARD_NUMBER = "creditCardNumber"`
`static final String`	`AUTOFILL_HINT_CREDIT_CARD_SECURITY_CODE = "creditCardSecurityCode"`
`static final String`	`AUTOFILL_HINT_EMAIL_ADDRESS = "emailAddress"`
`static final String`	`AUTOFILL_HINT_NAME = "name"`
`static final String`	`AUTOFILL_HINT_PASSWORD = "password"`
`static final String`	`AUTOFILL_HINT_PHONE = "phone"`
`static final String`	`AUTOFILL_HINT_POSTAL_ADDRESS = "postalAddress"`
`static final String`	`AUTOFILL_HINT_POSTAL_CODE = "postalCode"`
`static final String`	`AUTOFILL_HINT_USERNAME = "username"`
`static final int`	`AUTOFILL_TYPE_DATE = 4`
`static final int`	`AUTOFILL_TYPE_LIST = 3`
`static final int`	`AUTOFILL_TYPE_NONE = 0`
`static final int`	`AUTOFILL_TYPE_TEXT = 1`
`static final int`	`AUTOFILL_TYPE_TOGGLE = 2`
`static final int`	`CONTENT_SENSITIVITY_AUTO = 0`
`static final int`	`CONTENT_SENSITIVITY_NOT_SENSITIVE = 2`
`static final int`	`CONTENT_SENSITIVITY_SENSITIVE = 1`
`static final int`	`DRAG_FLAG_ACCESSIBILITY_ACTION = 1024`
`static final int`	`DRAG_FLAG_GLOBAL = 256`
`static final int`	`DRAG_FLAG_GLOBAL_PERSISTABLE_URI_PERMISSION = 64`
`static final int`	`DRAG_FLAG_GLOBAL_PREFIX_URI_PERMISSION = 128`
`static final int`	`DRAG_FLAG_GLOBAL_SAME_APPLICATION = 4096`
`static final int`	`DRAG_FLAG_GLOBAL_URI_READ = 1`
`static final int`	`DRAG_FLAG_GLOBAL_URI_WRITE = 2`
`static final int`	`DRAG_FLAG_HIDE_CALLING_TASK_ON_DRAG_START = 16384`
`static final int`	`DRAG_FLAG_OPAQUE = 512`
`static final int`	`DRAG_FLAG_START_INTENT_SENDER_ON_UNHANDLED_DRAG = 8192`
`static final int`	`DRAWING_CACHE_QUALITY_AUTO = 0` This field is deprecated.
`static final int`	`DRAWING_CACHE_QUALITY_HIGH = 1048576` This field is deprecated.
`static final int`	`DRAWING_CACHE_QUALITY_LOW = 524288` This field is deprecated.
`static final int[]`	`EMPTY_STATE_SET`
`static final int[]`	`ENABLED_FOCUSED_SELECTED_STATE_SET`
`static final int[]`	`ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`ENABLED_FOCUSED_STATE_SET`
`static final int[]`	`ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`ENABLED_SELECTED_STATE_SET`
`static final int[]`	`ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`ENABLED_STATE_SET`
`static final int[]`	`ENABLED_WINDOW_FOCUSED_STATE_SET`
`static final int`	`FIND_VIEWS_WITH_CONTENT_DESCRIPTION = 2`
`static final int`	`FIND_VIEWS_WITH_TEXT = 1`
`static final int`	`FOCUSABLE = 1`
`static final int`	`FOCUSABLES_ALL = 0`
`static final int`	`FOCUSABLES_TOUCH_MODE = 1`
`static final int`	`FOCUSABLE_AUTO = 16`
`static final int[]`	`FOCUSED_SELECTED_STATE_SET`
`static final int[]`	`FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`FOCUSED_STATE_SET`
`static final int[]`	`FOCUSED_WINDOW_FOCUSED_STATE_SET`
`static final int`	`FOCUS_BACKWARD = 1`
`static final int`	`FOCUS_DOWN = 130`
`static final int`	`FOCUS_FORWARD = 2`
`static final int`	`FOCUS_LEFT = 17`
`static final int`	`FOCUS_RIGHT = 66`
`static final int`	`FOCUS_UP = 33`
`static final int`	`GONE = 8`
`static final int`	`HAPTIC_FEEDBACK_ENABLED = 268435456`
`static final int`	`IMPORTANT_FOR_ACCESSIBILITY_AUTO = 0`
`static final int`	`IMPORTANT_FOR_ACCESSIBILITY_NO = 2`
`static final int`	`IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS = 4`
`static final int`	`IMPORTANT_FOR_ACCESSIBILITY_YES = 1`
`static final int`	`IMPORTANT_FOR_AUTOFILL_AUTO = 0`
`static final int`	`IMPORTANT_FOR_AUTOFILL_NO = 2`
`static final int`	`IMPORTANT_FOR_AUTOFILL_NO_EXCLUDE_DESCENDANTS = 8`
`static final int`	`IMPORTANT_FOR_AUTOFILL_YES = 1`
`static final int`	`IMPORTANT_FOR_AUTOFILL_YES_EXCLUDE_DESCENDANTS = 4`
`static final int`	`IMPORTANT_FOR_CONTENT_CAPTURE_AUTO = 0`
`static final int`	`IMPORTANT_FOR_CONTENT_CAPTURE_NO = 2`
`static final int`	`IMPORTANT_FOR_CONTENT_CAPTURE_NO_EXCLUDE_DESCENDANTS = 8`
`static final int`	`IMPORTANT_FOR_CONTENT_CAPTURE_YES = 1`
`static final int`	`IMPORTANT_FOR_CONTENT_CAPTURE_YES_EXCLUDE_DESCENDANTS = 4`
`static final int`	`INVISIBLE = 4`
`static final int`	`KEEP_SCREEN_ON = 67108864`
`static final int`	`LAYER_TYPE_HARDWARE = 2`
`static final int`	`LAYER_TYPE_NONE = 0`
`static final int`	`LAYER_TYPE_SOFTWARE = 1`
`static final int`	`LAYOUT_DIRECTION_INHERIT = 2`
`static final int`	`LAYOUT_DIRECTION_LOCALE = 3`
`static final int`	`LAYOUT_DIRECTION_LTR = 0`
`static final int`	`LAYOUT_DIRECTION_RTL = 1`
`static final int`	`MEASURED_HEIGHT_STATE_SHIFT = 16`
`static final int`	`MEASURED_SIZE_MASK = 16777215`
`static final int`	`MEASURED_STATE_MASK = -16777216`
`static final int`	`MEASURED_STATE_TOO_SMALL = 16777216`
`static final int`	`NOT_FOCUSABLE = 0`
`static final int`	`NO_ID = -1`
`static final int`	`OVER_SCROLL_ALWAYS = 0`
`static final int`	`OVER_SCROLL_IF_CONTENT_SCROLLS = 1`
`static final int`	`OVER_SCROLL_NEVER = 2`
`static final int[]`	`PRESSED_ENABLED_FOCUSED_SELECTED_STATE_SET`
`static final int[]`	`PRESSED_ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_ENABLED_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_ENABLED_SELECTED_STATE_SET`
`static final int[]`	`PRESSED_ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_ENABLED_STATE_SET`
`static final int[]`	`PRESSED_ENABLED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_FOCUSED_SELECTED_STATE_SET`
`static final int[]`	`PRESSED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_FOCUSED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_SELECTED_STATE_SET`
`static final int[]`	`PRESSED_SELECTED_WINDOW_FOCUSED_STATE_SET`
`static final int[]`	`PRESSED_STATE_SET`
`static final int[]`	`PRESSED_WINDOW_FOCUSED_STATE_SET`
`static final float`	`REQUESTED_FRAME_RATE_CATEGORY_DEFAULT`
`static final float`	`REQUESTED_FRAME_RATE_CATEGORY_HIGH = -4.0f`
`static final float`	`REQUESTED_FRAME_RATE_CATEGORY_LOW = -2.0f`
`static final float`	`REQUESTED_FRAME_RATE_CATEGORY_NORMAL = -3.0f`
`static final float`	`REQUESTED_FRAME_RATE_CATEGORY_NO_PREFERENCE = -1.0f`
`static final Property<View, Float>`	`ROTATION`
`static final Property<View, Float>`	`ROTATION_X`
`static final Property<View, Float>`	`ROTATION_Y`
`static final Property<View, Float>`	`SCALE_X`
`static final Property<View, Float>`	`SCALE_Y`
`static final int`	`SCREEN_STATE_OFF = 0`
`static final int`	`SCREEN_STATE_ON = 1`
`static final int`	`SCROLLBARS_INSIDE_INSET = 16777216`
`static final int`	`SCROLLBARS_INSIDE_OVERLAY = 0`
`static final int`	`SCROLLBARS_OUTSIDE_INSET = 50331648`
`static final int`	`SCROLLBARS_OUTSIDE_OVERLAY = 33554432`
`static final int`	`SCROLLBAR_POSITION_DEFAULT = 0`
`static final int`	`SCROLLBAR_POSITION_LEFT = 1`
`static final int`	`SCROLLBAR_POSITION_RIGHT = 2`
`static final int`	`SCROLL_AXIS_HORIZONTAL = 1`
`static final int`	`SCROLL_AXIS_NONE = 0`
`static final int`	`SCROLL_AXIS_VERTICAL = 2`
`static final int`	`SCROLL_CAPTURE_HINT_AUTO = 0`
`static final int`	`SCROLL_CAPTURE_HINT_EXCLUDE = 1`
`static final int`	`SCROLL_CAPTURE_HINT_EXCLUDE_DESCENDANTS = 4`
`static final int`	`SCROLL_CAPTURE_HINT_INCLUDE = 2`
`static final int`	`SCROLL_INDICATOR_BOTTOM = 2`
`static final int`	`SCROLL_INDICATOR_END = 32`
`static final int`	`SCROLL_INDICATOR_LEFT = 4`
`static final int`	`SCROLL_INDICATOR_RIGHT = 8`
`static final int`	`SCROLL_INDICATOR_START = 16`
`static final int`	`SCROLL_INDICATOR_TOP = 1`
`static final int[]`	`SELECTED_STATE_SET`
`static final int[]`	`SELECTED_WINDOW_FOCUSED_STATE_SET`
`static final int`	`SOUND_EFFECTS_ENABLED = 134217728`
`static final int`	`STATUS_BAR_HIDDEN = 1` This field is deprecated.
`static final int`	`STATUS_BAR_VISIBLE = 0` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_FULLSCREEN = 4` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_HIDE_NAVIGATION = 2` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_IMMERSIVE = 2048` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_IMMERSIVE_STICKY = 4096` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN = 1024` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION = 512` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_LAYOUT_STABLE = 256` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR = 16` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_LIGHT_STATUS_BAR = 8192` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_LOW_PROFILE = 1` This field is deprecated.
`static final int`	`SYSTEM_UI_FLAG_VISIBLE = 0` This field is deprecated.
`static final int`	`SYSTEM_UI_LAYOUT_FLAGS = 1536` This field is deprecated.
`static final int`	`TEXT_ALIGNMENT_CENTER = 4`
`static final int`	`TEXT_ALIGNMENT_GRAVITY = 1`
`static final int`	`TEXT_ALIGNMENT_INHERIT = 0`
`static final int`	`TEXT_ALIGNMENT_TEXT_END = 3`
`static final int`	`TEXT_ALIGNMENT_TEXT_START = 2`
`static final int`	`TEXT_ALIGNMENT_VIEW_END = 6`
`static final int`	`TEXT_ALIGNMENT_VIEW_START = 5`
`static final int`	`TEXT_DIRECTION_ANY_RTL = 2`
`static final int`	`TEXT_DIRECTION_FIRST_STRONG = 1`
`static final int`	`TEXT_DIRECTION_FIRST_STRONG_LTR = 6`
`static final int`	`TEXT_DIRECTION_FIRST_STRONG_RTL = 7`
`static final int`	`TEXT_DIRECTION_INHERIT = 0`
`static final int`	`TEXT_DIRECTION_LOCALE = 5`
`static final int`	`TEXT_DIRECTION_LTR = 3`
`static final int`	`TEXT_DIRECTION_RTL = 4`
`static final Property<View, Float>`	`TRANSLATION_X`
`static final Property<View, Float>`	`TRANSLATION_Y`
`static final Property<View, Float>`	`TRANSLATION_Z`
`static final String`	`VIEW_LOG_TAG = "View"`
`static final int`	`VISIBLE = 0`
`static final int[]`	`WINDOW_FOCUSED_STATE_SET`
`static final Property<View, Float>`	`X`
`static final Property<View, Float>`	`Y`
`static final Property<View, Float>`	`Z`

Inherited methods

From android.widget.ImageButton

`CharSequence`	`getAccessibilityClassName()`
`PointerIcon`	`onResolvePointerIcon(MotionEvent event, int pointerIndex)`
`boolean`	`onSetAlpha(int alpha)`

From android.widget.ImageView

`void`	`animateTransform(Matrix matrix)`
`final void`	`clearColorFilter()`
`void`	`drawableHotspotChanged(float x, float y)`
`boolean`	`getAdjustViewBounds()`
`int`	`getBaseline()`
`boolean`	`getBaselineAlignBottom()`
`ColorFilter`	`getColorFilter()`
`boolean`	`getCropToPadding()`
`Drawable`	`getDrawable()`
`int`	`getImageAlpha()`
`Matrix`	`getImageMatrix()`
`BlendMode`	`getImageTintBlendMode()`
`ColorStateList`	`getImageTintList()`
`PorterDuff.Mode`	`getImageTintMode()`
`int`	`getMaxHeight()`
`int`	`getMaxWidth()`
`ImageView.ScaleType`	`getScaleType()`
`void`	`invalidateDrawable(Drawable dr)`
`boolean`	`isOpaque()`
`void`	`jumpDrawablesToCurrentState()`
`void`	`onAttachedToWindow()`
`int[]`	`onCreateDrawableState(int extraSpace)`
`void`	`onDetachedFromWindow()`
`void`	`onDraw(Canvas canvas)`
`void`	`onMeasure(int widthMeasureSpec, int heightMeasureSpec)`
`void`	`onRtlPropertiesChanged(int layoutDirection)`
`void`	`onVisibilityAggregated(boolean isVisible)`
`void`	`setAdjustViewBounds(boolean adjustViewBounds)`
`void`	`setAlpha(int alpha)` This method is deprecated.
`void`	`setBaseline(int baseline)`
`void`	`setBaselineAlignBottom(boolean aligned)`
`void`	`setColorFilter(ColorFilter cf)`
`void`	`setCropToPadding(boolean cropToPadding)`
`boolean`	`setFrame(int l, int t, int r, int b)`
`void`	`setImageAlpha(int alpha)`
`void`	`setImageIcon(Icon icon)`
`void`	`setImageMatrix(Matrix matrix)`
`void`	`setImageState(int[] state, boolean merge)`
`void`	`setImageTintBlendMode(BlendMode blendMode)`
`void`	`setImageTintList(ColorStateList tint)`
`void`	`setImageTintMode(PorterDuff.Mode tintMode)`
`void`	`setMaxHeight(int maxHeight)`
`void`	`setMaxWidth(int maxWidth)`
`void`	`setScaleType(ImageView.ScaleType scaleType)`
`void`	`setSelected(boolean selected)`
`void`	`setVisibility(int visibility)`
`boolean`	`verifyDrawable(Drawable dr)`

From android.view.View

Public constructors

AppCompatImageButton

Added in 1.1.0

public AppCompatImageButton(@NonNull Context context)

AppCompatImageButton

Added in 1.1.0

public AppCompatImageButton(
 @NonNull Context context,
 @Nullable AttributeSet attrs
)

AppCompatImageButton

Added in 1.1.0

public AppCompatImageButton(
 @NonNull Context context,
 @Nullable AttributeSet attrs,
 int defStyleAttr
)

Public methods

hasOverlappingRendering

public boolean hasOverlappingRendering()

setBackgroundDrawable

Added in 1.1.0

public void setBackgroundDrawable(@Nullable Drawable background)

setBackgroundResource

public void setBackgroundResource(@DrawableRes int resId)

setImageBitmap

public void setImageBitmap(Bitmap bm)

setImageDrawable

public void setImageDrawable(@Nullable Drawable drawable)

setImageLevel

public void setImageLevel(int level)

setImageResource

public void setImageResource(@DrawableRes int resId)

setImageURI

public void setImageURI(@Nullable Uri uri)

Protected methods

drawableStateChanged

protected void drawableStateChanged()

Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Last updated 2026-04-08 UTC.

X
Follow @AndroidDev on X
YouTube
Check out Android Developers on YouTube
LinkedIn
Connect with the Android Developers community on LinkedIn

java.lang.Object
↳	android.view.View
	↳	android.widget.ImageView
		↳	android.widget.ImageButton
			↳	androidx.appcompat.widget.AppCompatImageButton

Sunbelt Computer Software

PL/B Language Development and Support

AppCompatImageButton

Summary

Public constructors

Public methods

Protected methods

Inherited Constants

Inherited methods

Public constructors

AppCompatImageButton

AppCompatImageButton

AppCompatImageButton

Public methods

hasOverlappingRendering

setBackgroundDrawable

setBackgroundResource

setImageBitmap

setImageDrawable

setImageLevel

setImageResource

setImageURI

Protected methods

drawableStateChanged