Android中Fragmen首选项使用自定义的ListPreference的方法

首选项这个名词对于熟悉Android的朋友们一定不会感到陌生，它经常用来设置软件的运行参数。
Android提供了一种健壮并且灵活的框架来处理首选项。它提供了简单的API来隐藏首选项的读取和持久化，并且提供了一个优雅的首选项界面。
几种常见的首选项：
（1）CheckBoxPreference：用来打开或关闭某个功能
（2）ListPreference：用来从多个选项中选择一个值；
（3）EditTextPreference：用来配置一段文字信息；
（4）Preference：用来执行相关的自定义操作(上图中的清除缓存、历史记录、表单、cookie都属于此项)；
（5）RingtonePreference：专门用来为用户设置铃声。
当我们使用首选项框架时，用户每更改一项的值后，系统就会立即在/data/data/[PACKAGE_NAME]/shared_prefs下生成一个[PACKAGE_NAME]_preferences.xml的文件，文件会记录最新的配置信息。
那么本文要讲的就是其中的ListPreference，以及通过PreferenceFragment来使用自定义的ListPreference。

1. 自定义属性
添加文件res/values/attrs.xml，内容如下：

<?xml version="1.0" encoding="utf-8"?>

说明：
(01) name="IconListPreference"，与自定义的ListPreference类的名称相对应。后面会实现一个继承于ListPreference的IconListPreference.java。
(02) name="entryIcons"，这是属性的名称。
(03) format="reference"，这描述属性的值是引用类型。因为，后面会根据资源id设置该属性，所以将属性格式设为reference。如果是颜色，设为format="color"；如果是布尔类型，format="boolean"；如果是字符串，设为format="string"。
2. 自定义ListPreference
2.1 构造函数

public IconListPreference(Context context, AttributeSet attrs) { super(context, attrs); mContext = context; // 获取自定义的属性(attrs.xml中)对应行的TypedArray TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.IconListPreference); // 获取entryIcons属性对应的值 int iconResId = a.getResourceId(R.styleable.IconListPreference_entryIcons, -1); if (iconResId != -1) {  setEntryIcons(iconResId); }  // 获取Preferece对应的key mKey = getKey(); // 获取SharedPreferences mPref = PreferenceManager.getDefaultSharedPreferences(context); // 获取SharedPreferences.Editor mEditor = mPref.edit(); // 获取Entry // 注意：如果配置文件中没有android:entries属性，则getEntries()为空； mEntries = getEntries(); // 获取Entry对应的值 // 注意：如果配置文件中没有android:entryValues属性，则getEntries()为空 mEntryValues = getEntryValues(); // 获取该ListPreference保存的值 String value = mPref.getString(mKey, ""); mPosition = findIndexOfValue(value); // 设置Summary if (mPosition!=-1) {  setSummary(mEntries[mPosition]);  setIcon(mEntryIcons[mPosition]); }  a.recycle();}

说明：
(01) 首先，根据obtainStyledAttributes()能获取自定义属性对应的TypedArray对象。
(02) 在自定义属性中，entryIcons对应的类名是IconListPreference。因为需要通过"类名"_"属性名"，即IconListPreference_entryIcons的方式来获取资源信息。
(03) getKey()是获取Preferece对应的Key。该Key是Preference对象的唯一标识。
(04) getEntries()是获取Preferece的Entry数组。
(05) getEntryValues()是获取Preferece的Entry对应的值的数组。
(06) setSummary()是设置Preferece的summary标题内容。
(07) setIcon()是设置Preferece的图标。
2.2 自定义ListPreference中图片相关代码

/** * 设置图标：icons数组 */private void setEntryIcons(int[] entryIcons) { mEntryIcons = entryIcons;}/** * 设置图标：根据icon的id数组 */public void setEntryIcons(int entryIconsResId) { TypedArray icons = getContext().getResources().obtainTypedArray(entryIconsResId); int[] ids = new int[icons.length()]; for (int i = 0; i < icons.length(); i++)  ids[i] = icons.getResourceId(i, -1); setEntryIcons(ids); icons.recycle();}

说明：这两个函数是读取图片信息的。
2.3 自定义ListPreference弹出的列表选项

@Overrideprotected void onPrepareDialogBuilder(Builder builder) { super.onPrepareDialogBuilder(builder); IconAdapter adapter = new IconAdapter(mContext); builder.setAdapter(adapter, null);}

说明：点击ListPreference，会弹出一个列表对话框。通过重写onPrepareDialogBuilder()，我们可以自定义弹出的列表对话框。这里是通过IconAdapter来显示的。

public class IconAdapter extends BaseAdapter{ private LayoutInflater mInflater; public IconAdapter(Context context){  this.mInflater = LayoutInflater.from(context); } @Override public int getCount() {  return mEntryIcons.length; } @Override public Object getItem(int arg0) {  return null; } @Override public long getItemId(int arg0) {  return 0; } @Override public View getView(int position, View convertView, ViewGroup parent) {  ViewHolder holder = null;  if (convertView == null) {   holder = new ViewHolder();   convertView = mInflater.inflate(R.layout.icon_adapter, parent, false);   holder.layout = (LinearLayout)convertView.findViewById(R.id.icon_layout);   holder.img = (ImageView)convertView.findViewById(R.id.icon_img);   holder.info = (TextView)convertView.findViewById(R.id.icon_info);   holder.check = (RadioButton)convertView.findViewById(R.id.icon_check);   convertView.setTag(holder);  }else {   holder = (ViewHolder)convertView.getTag();  }  holder.img.setBackgroundResource(mEntryIcons[position]);  holder.info.setText(mEntries[position]);  holder.check.setChecked(mPosition == position);  final ViewHolder fholder = holder;  final int fpos = position;  convertView.setOnClickListener(new View.OnClickListener() {   @Override   public void onClick(View v) {    v.requestFocus();    // 选中效果    fholder.layout.setBackgroundColor(Color.CYAN);    // 更新mPosition    mPosition = fpos;    // 更新Summary    IconListPreference.this.setSummary(mEntries[fpos]);    IconListPreference.this.setIcon(mEntryIcons[fpos]);    // 更新该ListPreference保存的值    mEditor.putString(mKey, mEntryValues[fpos].toString());    mEditor.commit();    // 取消ListPreference设置对话框    getDialog().dismiss();   }  });  return convertView; } // ListPreference每一项对应的Layout文件的结构体 private final class ViewHolder {  ImageView img;  TextView info;  RadioButton check;  LinearLayout layout; }}

说明：弹出的列表对话框中的每一项的内容是通过布局icon_adapter.xml来显示的。下面看看icon_adapter.xml的源码。

<?xml version="1.0" encoding="utf-8"?>

至此，自定义的ListPreference就算完成了。下面就是如何使用它了。
3. 使用该自定义ListPreference
我们是通过PreferenceFragment使用该自定义的ListPreference。
3.1 PreferenceFragment的配置文件
res/xml/preferences.xml的内容如下：

说明：该配置文件中使用了"系统默认的ListPreference"和"自定义的ListPreference(即IconListPreference)"。
注意，IconListPreference中的"iconlistpreference:entryIcons"属性。前面的"iconlistpreference"与该文件的命名空间表示"xmlns:iconlistpreference="http://schemas.android.com/apk/res/com.skw.fragmenttest"中的iconlistpreference一样! 而entryIcons则是我们自定义的属性名称。
3.2 自定义PreferenceFragment的代码

public class PrefsFragment extends PreferenceFragment { @Override public void onCreate(Bundle savedInstanceState) {  super.onCreate(savedInstanceState);  addPreferencesFromResource(R.xml.preferences); } ...}

4. 使用PrefsFragment
下面，就可以在Activity中使用该PrefsFragment了。
4.1 使用PrefsFragment的Activity的代码

public class FragmentTest extends Activity { @Override public void onCreate(Bundle savedInstanceState) {  super.onCreate(savedInstanceState);  setContentView(R.layout.main);  // 获取FragmentManager  FragmentManager fragmentManager = getFragmentManager();  // 获取FragmentTransaction    FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();  PrefsFragment fragment = new PrefsFragment();  // 将fragment添加到容器frag_example中  fragmentTransaction.add(R.id.prefs, fragment);  fragmentTransaction.commit(); } }

4.2 使用PrefsFragment的Activity的配置文件
res/layout/main.xml的内容如下：

<?xml version="1.0" encoding="utf-8"?>

更多相关文章

随机推荐