Android 中文API （33） —— Checkable

此接口定義了一個擴展，使得繼承它的視圖控件具有可選狀態屬性。

正文

　　一、結構

　　　　public interface Checkable

　　　　間接子類

　　　　　　CheckBox, CheckedTextView, CompoundButton, RadioButton, ToggleButton

此接口定義了一個擴展，使得繼承它的視圖控件具有可選狀態屬性。

　　　　（譯者注：凡是繼承了此接口的類，便有了android:checked 屬性)

三、公共方法

public abstract boolean isChecked ()

     查詢當前視圖控件的選中狀態。

返回：

返回一個boolean的值來表示當前視圖控件的選中狀態，如果當前控件被選中，返回true值，否則返回false值。

     （譯者注：並不一定是控件上顯示了對號或者點就是被選中，很可能某個思維不同於常人的程序員會把有對號的定義爲未選中而返回一個false。當然這只是可能，按照常理來說還是有對號和點的表示選中true，反之亦然。）

public abstract void setChecked (boolean checked)

     設置當前視圖控件的選中狀態。（譯者注：

執行前	執行	執行後
任何狀態	setChecked(true)	選中
任何狀態	setChecked(false)	未選中

參數：

   checked 指定控件的選中狀態true表示設置爲選中，false爲未選中。

此方法用來切換當前視圖控件的選中狀態。（譯者注：即將視圖控件的當前狀態變爲其相反狀態

執行前	執行	執行後
選中	toggle()	未選中
未選中	toggle()	選中

開源項目: AndroidSample-Topeka中的使用:

使用這個接口需要實現3個方法：

  @Override public void setChecked(boolean b) {

  }

  @Override public boolean isChecked() {

  }

  @Override public void toggle() {

  }

package com.sync.androidsamples.googlesamples.topeka.topeka.widget;

import android.annotation.SuppressLint;
import android.content.Context;
import android.graphics.Canvas;
import android.graphics.drawable.BitmapDrawable;
import android.graphics.drawable.Drawable;
import android.os.Build;
import android.support.annotation.DrawableRes;
import android.support.annotation.NonNull;
import android.support.v4.content.ContextCompat;
import android.support.v4.content.res.ResourcesCompat;
import android.support.v4.graphics.drawable.RoundedBitmapDrawable;
import android.support.v4.graphics.drawable.RoundedBitmapDrawableFactory;
import android.util.AttributeSet;
import android.widget.Checkable;
import android.widget.ImageView;
import com.sync.androidsamples.R;
import com.sync.androidsamples.googlesamples.topeka.topeka.helper.ApiLevelHelper;
import com.sync.androidsamples.googlesamples.topeka.topeka.widget.outlineprovider.RoundOutlineProvider;

/**
 * A simple view that wraps an avatar.
 * Created by Administrator on 2016/8/18 0018.
 */
public class AvatarView extends ImageView implements Checkable{

  private boolean mChecked;

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

  public AvatarView(Context context, AttributeSet attrs) {
    super(context, attrs);
  }

  public AvatarView(Context context, AttributeSet attrs, int defStyleAttr) {
    super(context, attrs, defStyleAttr);
  }

  @Override public void setChecked(boolean b) {
    mChecked = b;
    invalidate();
  }

  @Override public boolean isChecked() {
    return mChecked;
  }

  @Override public void toggle() {
    setChecked(!mChecked);
  }

  @SuppressLint("NewApi")
  public void setAvatar(@DrawableRes int resId) {
    if (ApiLevelHelper.isAtLeast(Build.VERSION_CODES.LOLLIPOP)) {
      //爲了裁剪一個可繪製的視圖形狀，需要先設置一個outline然後調用View.setClipToOutline方法
      setClipToOutline(true);  
      setImageResource(resId);
    } else {
      setAvatarPreLollipop(resId);
    }
  }

  private void setAvatarPreLollipop(@DrawableRes int redId) {
    Drawable drawable = ResourcesCompat.getDrawable(getResources(), redId,
        getContext().getTheme());
    BitmapDrawable bitmapDrawable = (BitmapDrawable) drawable;
    RoundedBitmapDrawable roundedBitmapDrawable = RoundedBitmapDrawableFactory.create(getResources(),
        bitmapDrawable.getBitmap());
    roundedBitmapDrawable.setCircular(true);
    setImageDrawable(roundedBitmapDrawable);
  }

  @Override protected void onDraw(@NonNull Canvas canvas) {
    super.onDraw(canvas);
    if (mChecked) {
      Drawable border = ContextCompat.getDrawable(getContext(), R.drawable.selector_avatar);
      border.setBounds(0,0,getWidth(),getHeight());
      border.draw(canvas);
    }
  }

  @Override protected void onSizeChanged(int w, int h, int oldw, int oldh) {
    super.onSizeChanged(w, h, oldw, oldh);
    if (ApiLevelHelper.isLowerThan(Build.VERSION_CODES.LOLLIPOP)) {
      return;
    }
    if (w > 0 && h > 0) {
      setOutlineProvider(new RoundOutlineProvider(Math.min(w, h)));
    }
  }
}