Android开发：如何为ImageButton设置前景图？适配API Level 19

嘿，作为Android开发新手碰到这个问题太正常啦！毕竟API 19（也就是咱们常说的KitKat版本）确实没有系统原生支持ImageButton直接设置前景图的API——setForeground()方法是从API 23才开始引入的。不过别慌，咱们有几个实用的替代方案，一步步来解决：

方案1：用FrameLayout嵌套实现前景效果 #

这是最直观、零代码的方案，把ImageButton和一个用来做前景的视图（比如ImageView）放在同一个FrameLayout里，让前景视图覆盖在按钮上方即可。

布局代码示例： #

<FrameLayout
    android:layout_width="wrap_content"
    android:layout_height="wrap_content">

    <!-- 你的基础ImageButton -->
    <ImageButton
        android:id="@+id/my_image_btn"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:src="@drawable/your_button_base_icon" />

    <!-- 前景图视图 -->
    <ImageView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:src="@drawable/your_foreground_icon"
        android:padding="8dp" <!-- 可以通过内边距调整前景图位置 -->
        android:clickable="false" <!-- 必须设置，避免拦截按钮的点击事件 -->
        android:focusable="false" />
</FrameLayout>

方案2：自定义ImageButton重绘前景 #

如果不想用嵌套布局，也可以自己写一个自定义ImageButton，通过重写onDraw()方法手动绘制前景图，这样复用性更强。

第一步：自定义View代码 #

public class ForegroundImageButton extends ImageButton {
    private Drawable mForegroundDrawable;

    public ForegroundImageButton(Context context) {
        super(context);
    }

    public ForegroundImageButton(Context context, AttributeSet attrs) {
        super(context, attrs);
        // 读取自定义属性里的前景图
        TypedArray ta = context.obtainStyledAttributes(attrs, R.styleable.ForegroundImageButton);
        mForegroundDrawable = ta.getDrawable(R.styleable.ForegroundImageButton_foreground);
        ta.recycle();
    }

    // 提供动态设置前景图的方法
    public void setForegroundDrawable(Drawable drawable) {
        mForegroundDrawable = drawable;
        invalidate(); // 通知视图重绘
    }

    @Override
    protected void onDraw(Canvas canvas) {
        super.onDraw(canvas);
        // 如果前景图不为空，就绘制在按钮上方
        if (mForegroundDrawable != null) {
            mForegroundDrawable.setBounds(0, 0, getWidth(), getHeight());
            mForegroundDrawable.draw(canvas);
        }
    }
}

第二步：添加自定义属性 #

在res/values/attrs.xml里添加自定义属性（如果没有这个文件就新建一个）：

<declare-styleable name="ForegroundImageButton">
    <attr name="foreground" format="reference" />
</declare-styleable>

第三步：布局中使用自定义按钮 #

<com.yourpackage.ForegroundImageButton
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:src="@drawable/button_base_icon"
    app:foreground="@drawable/your_foreground_icon" />

方案3：用LayerList合并背景与前景（状态相关场景） #

如果你的前景图需要跟随按钮状态（比如按下、选中）变化，可以把背景和前景合并成一个LayerList，再通过StateListDrawable绑定状态，直接设置给ImageButton的src或background。

示例drawable文件（比如btn_with_foreground.xml）： #

<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 按钮按下状态 -->
    <item android:state_pressed="true">
        <layer-list>
            <item android:drawable="@drawable/btn_bg_pressed" />
            <item android:drawable="@drawable/foreground_pressed" />
        </layer-list>
    </item>
    <!-- 按钮默认状态 -->
    <item>
        <layer-list>
            <item android:drawable="@drawable/btn_bg_normal" />
            <item android:drawable="@drawable/foreground_normal" />
        </layer-list>
    </item>
</selector>

布局中使用： #

<ImageButton
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:src="@drawable/btn_with_foreground" />

可以根据你的实际需求选方案：静态前景用方案1最省事，需要复用控件选方案2，状态相关的场景选方案3就对啦～

内容的提问来源于stack exchange，提问作者Mammadali Alizadeh