Preference偏好设置使用方法

学习了一下Preference偏好设置的方法，这里记录总结，供学习参考。代码参考了android Settings packages/app/Settings里偏好设置，以及自定义Preference的用法。

在API 11以后，推荐PreferenceFragment的addPreferencesFromResource方法，原来的PrefereneceActivity已经废弃。

public class PreferenceSettings extends Activity{

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        getFragmentManager().beginTransaction().replace(android.R.id.content,
                new SettingFragment()).commit();
    }
}

public class SettingFragment extends PreferenceFragment implements Preference.OnPreferenceChangeListener{

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        addPreferencesFromResource(R.layout.preference_screen);
    }

    @Override
    public boolean onPreferenceChange(Preference preference, Object o) {
        return false;
    }
}

preference_screen.xml

<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <PreferenceCategory android:title="簡單偏好">

        <CheckBoxPreference
            android:key="checkbox_preference"
            android:summary="这是一个checkbox开关按钮"
            android:title="Checkbox开关偏好" />
        <SwitchPreference
            android:key="switch_preference"
            android:summary="这是一个switch开关按钮"
            android:title="Switch开关偏好"/>
        <ListPreference
            android:key="screen_timeout"
            android:title="超是時間"
            android:summary="screen timeout summary"
            android:persistent="false"
            android:entries="@array/screen_timeout_entries"
            android:entryValues="@array/screen_timeout_values" />
        <com.example.zxz.asdemo.view.DropDownPreference
            android:key="DropDown"
            android:title="drop down preference list"
            android:entries="@array/screen_timeout_entries"
            android:entryValues="@array/screen_timeout_values"/>

    </PreferenceCategory>

    <PreferenceCategory android:title="基于对话框的偏好">

        <EditTextPreference
            android:dialogTitle="enter type"
            android:key="edittext_preference"
            android:summary="使用一个文本框对话框"
            android:title="文本输入偏好" />
    </PreferenceCategory>

    <PreferenceCategory android:title="启动偏好">

        <PreferenceScreen
            android:key="screen_preference"
            android:summary="显示另一个偏好屏幕"
            android:title="屏幕">

            <CheckBoxPreference
                android:key="next_screen_checkbox_preference"
                android:summary="另一个屏幕上的偏好"
                android:title="开关偏好" />
        </PreferenceScreen>

        <PreferenceScreen
            android:summary="通过intent启动一个Activity"
            android:title="intent偏好">

            <intent
                android:action="android.intent.action.VIEW"
                android:data="http://www.baidu.com" />
        </PreferenceScreen>

        <PreferenceScreen
            android:key="brightness"
            android:title="屏幕亮度">
            <intent
                android:action="android.intent.action.SHOW_BRIGHTNESS_DIALOG" />
        </PreferenceScreen>

        <PreferenceScreen
            android:key="screensaver"
            android:title="screensaver_settings_title"
            android:fragment="com.example.zxz.asdemo.ui.DisplaySettingsFragment"/>
    </PreferenceCategory>

    <PreferenceCategory android:title="偏好属性">

        <CheckBoxPreference
            android:key="parent_checkbox_preference"
            android:summary="这是一个父开关"
            android:title="父开关" />
        <CheckBoxPreference
            android:dependency="parent_checkbox_preference"
            android:key="child_checkbox_preference"
            android:layout="?android:attr/preferenceLayoutChild"
            android:summary="这是一个子开关"
            android:title="子开关" />
    </PreferenceCategory>
</PreferenceScreen>

PreferenceGroup  是一个Preference的集合，可以包含多个Preference。

PreferenceCategory 是PreferenceGroup的子类，用于分类。

PreferenceScreen 代表着preference的层次机构中的最顶层，为了显示这个类，需要一个PreferenceActivity指向一个实例化的PreferenceScreen。PreferenceActivity用来来显示的，是最顶层的。PreferenceScreen 用法：

1. PreferenceActivity指向它的时候，也就是PreferenceActivity调用addPreferencesFromResource的时候才被当做一个根（可以理解为布局的最外层），但是是没有显示的.

2.出现在Preference层次机构内部的时候， 可以显示出来。但是当被点击的时候会显示一个对话框形式的Preference 或者直接启动一个Intent。并且它里面的内容不会被显示。参见实例

 

偏好设置层次结构可以有很多种方式形成：

1、从一个XML文件制定的层次结构。

2、从不同的activity，每一个activity通过meta-data在一个XML文件中制定他自己的偏好设置。

3、从一个以PreferenceScreen为根的层次结构对象。学习这种方式

 

为了从一个XML文件中获取界面，使用addPreferenceFromResource(id)方法。根元素应该使用PreferenceScreen。随后的元素可以指向实际的偏好设置的子类。 

为指定一个Intent来查询都带有各自偏好设置的activitiy，使用addPreferenceFromIntent方法。每个activity可以在AndroidManifes.xml文件中指定meta-data来指向一个XML文件资源。

自定义Preference类

public class DropDownPreference extends Preference {
    private final ArrayAdapter<String> mAdapter;
    private final Spinner mSpinner;
    private final ArrayList<Object> mValues = new ArrayList<Object>();
    private int mSelectedPosition = -1;

    public DropDownPreference(Context context) {
        this(context, null);
    }

    public DropDownPreference(Context context, AttributeSet attrs) {
        super(context, attrs);
        mAdapter = new ArrayAdapter<String>(context,
                android.R.layout.simple_spinner_dropdown_item);

        mSpinner = new Spinner(context);

        mSpinner.setVisibility(View.INVISIBLE);
        mSpinner.setAdapter(mAdapter);
        mSpinner.setOnItemSelectedListener(new AdapterView.OnItemSelectedListener() {
            @Override
            public void onItemSelected(AdapterView<?> parent, View v, int position, long id) {
                setSelectedItem(position, true);
            }

            @Override
            public void onNothingSelected(AdapterView<?> parent) {
                // noop
            }
        });
        setPersistent(false);
        setOnPreferenceClickListener(new OnPreferenceClickListener() {
            @Override
            public boolean onPreferenceClick(Preference preference) {
                mSpinner.performClick();
                return true;
            }
        });

        // Support XML specification like ListPreferences do.
        TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.DropDownPreference);
        try {
            CharSequence[] entries = a.getTextArray(R.styleable.DropDownPreference_android_entries);
            CharSequence[] values = a.getTextArray(R.styleable.DropDownPreference_android_entryValues);
            if (entries != null && values != null) {
                for (int i = 0; i < entries.length; i++) {
                    addItem(entries[i].toString(), values[i]);
                }
            }
        } finally {
            a.recycle();//TypedArray需要回收
        }

    }

    @Override
    protected void onBindView(View view) {
        super.onBindView(view);
        if (view.equals(mSpinner.getParent())) return;
        if (mSpinner.getParent() != null) {
            ((ViewGroup)mSpinner.getParent()).removeView(mSpinner);
        }
        final ViewGroup vg = (ViewGroup)view;
        vg.addView(mSpinner, 0);
        final ViewGroup.LayoutParams lp = mSpinner.getLayoutParams();
        lp.width = 0;
        mSpinner.setLayoutParams(lp);
    }

    private void addItem(String caption, Object value) {
        mAdapter.add(caption);
        mValues.add(value);
    }

    public void setSelectedItem(int position, boolean fromSpinner) {
        if (fromSpinner && position == mSelectedPosition) {
            return;
        }
        final Object value = mValues.get(position);
        mSpinner.setSelection(position);
        mSelectedPosition = mSpinner.getSelectedItemPosition();
        setSummary(mAdapter.getItem(position));
        final boolean disableDependents = value == null;
        notifyDependencyChange(disableDependents);
    }

}