android.preference

此包下的类主要以Preference为父类，PreferenceActivity继承自ListActivity用来显示UI，以ListView形式显示，preference主要用来做配置文件，所做的选择以Sharedpreference（xml）形式存于程序目录下。

使用方式:定义一个xml（随便放哪，最好在res下建个xml文件夹，放里面）文件，在java代码中addPreferencesFromResource(int res)，最基本的preference就完成了。

xml文件内以PreferenceScreen作为根节点，比如：

 <PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">
     <ListPreference android:entryValues="@array/r"
         android:entries="@array/r"
         android:title="qqqqqqqq"
          android:summary="wwwwwwwwww"
          android:dialogTitle="hhh" android:key="55"/>
     <CheckBoxPreference />
 </PreferenceScreen>

Preference ：所有preference的父类，其属性子类继承

XML属性：

android:key   用于存储、取出数据的key。

android:title   用于显示的标题，标题在上面一行，最多有两行。

android:summary   摘要，配置的简要说明，显示在标题下面

android:selectable  是否能点取选择，设置false则此条preference不可选（lose focus）

android:enabled    是否起作用，false则能点取，但是不作用（有焦点）

android:shouldDisableView   当enabled设置为false，此属性设置为true时，preference所代表的item变暗

android:layout    自定义item的View

DialogPreference：弹dialog的preference的父类，不直接在XML文件中定义，而用其子类。继承自Preference 

android:dialogIcon    弹出的dialog的图标

android:dialogMessage  dialog的消息

android:dialogTitle     dialog的标题

android:negativeButtonText   dialog的取消按钮上面的文字

android:positiveButtonText    dialog的确定按钮上的文字

android:dialogLayout     自定义dialog布局

ListPreference：点击后弹dialog，dialog内是个单选ListView。继承自DialogPreference

XML属性：

android:entries   用于显示的数组，弹出来的Dialog中ListView所显示的内容

android:entryValues  被选取后所得到的数据，数组，对应entries。

不能设置dialogMessage，否则ListView将被Message内容覆盖。

EditTextPreference：点击后弹dialog，dialog的View部分是个EditText。继承自DialogPreference

XML属性：没有独有属性

TwoStatePreference：代表两种状态转换的配置类，不直接用，而用其子类

XML属性：没有独有属性

CheckBoxPreference： 带checkbox的item，点击后checkbox状态改变。4.0继承自TwoStatePreference，2.3继承自Preference

XML属性：

android:summaryOff  当checkbox状态为false时，显示的摘要内容

android:summaryOn  当checkbox状态为true时，显示的摘要内容

PreferenceCategory：对preference进行分组。

XML属性：没有独有属性

源码分析：

当点击Preference的Item时，首先触发方法：performClick(PreferenceScreen preferenceScreen) 

 void performClick(PreferenceScreen preferenceScreen) {

     if (!isEnabled()) {
         return;
     }

     onClick();

     if (mOnClickListener != null && mOnClickListener.onPreferenceClick(this)) {
         return;
     }

     PreferenceManager preferenceManager = getPreferenceManager();
     if (preferenceManager != null) {
         PreferenceManager.OnPreferenceTreeClickListener listener = preferenceManager
                 .getOnPreferenceTreeClickListener();
         if (preferenceScreen != null && listener != null
                 && listener.onPreferenceTreeClick(preferenceScreen, this)) {
             return;
         }
     }

     if (mIntent != null) {
         Context context = getContext();
         context.startActivity(mIntent);
     }
 }

很明显，如果设置了setEnable(false),后面所有代码都失去作用了。

onClick()是个protect的空方法，留给子类用的。下面的这一段代码决定了监听事件的响应，如果设置了监听，那么点击时调用监听事件得到返回值，如果返回true，则后面的代码不执行了，false则继续执行。

 if (mOnClickListener != null && mOnClickListener.onPreferenceClick(this)) {
     return;
 }

下面一段代码决定了点击后跳转到另一个Activity。

 if (mIntent != null) {
     Context context = getContext();
     context.startActivity(mIntent);
 }

其中mIntent可通过setIntent（Intent intent）方法设定，也可在布局文件中如下设定

 <Preference android:title="@string/ua_settings" >

     <intent
         android:action="android.intent.action.webview"
         android:targetClass="com.yeezone.engtest.Uaagent"
         android:targetPackage="com.yeezone.engtest" />
 </Preference>

源码版本2.3：

CheckboxPreference：

实现父类Preference的onclick方法：

 @Override
 protected void onClick() {
     super.onClick();

     boolean newValue = !isChecked();

     // in onBindView() an AccessibilityEventViewClickedType is sent to announce the change
     // not sending
     mSendAccessibilityEventViewClickedType = true;

     if (!callChangeListener(newValue)) {
         return;
     }

     setChecked(newValue);
 }

其中callChangeListener(newValue)方法代码如下：

 protected boolean callChangeListener(Object newValue) {
     return mOnChangeListener == null ? true : mOnChangeListener.onPreferenceChange(this, newValue);
 }

上面这个方法中可以看出，如果对这个Preference进行了Preference.OnPreferenceChangeListener监听，并且监听的返回值为true那么后面的代码将不会再执行。

setChecked(newValue)方法会把newValue存到配置文件中去。

DialogPreference：不直接使用，而是作为父类使用

实现父类Preference的onclick方法：

 @Override
 protected void onClick() {
     showDialog(null);
 }

其中showDialog方法主要用来构建并显示一个AlertDialog，并且调用onPrepareDialogBuilder(mBuilder);方法，并且对Dialog实现dissmiss监听，在onDismiss方法中调用方法onDialogClosed(mWhichButtonClicked == DialogInterface.BUTTON_POSITIVE);，onPrepareDialogBuilder与onDialogClosed是空方法，留给子类实现。showDialog代码如下：

 protected void showDialog(Bundle state) {
        Context context = getContext();

        mWhichButtonClicked = DialogInterface.BUTTON_NEGATIVE;

        mBuilder = new AlertDialog.Builder(context)
            .setTitle(mDialogTitle)
            .setIcon(mDialogIcon)
            .setPositiveButton(mPositiveButtonText, this)
            .setNegativeButton(mNegativeButtonText, this);

        View contentView = onCreateDialogView();
        if (contentView != null) {
            onBindDialogView(contentView);
            mBuilder.setView(contentView);
        } else {
            mBuilder.setMessage(mDialogMessage);
        }

        onPrepareDialogBuilder(mBuilder);

        getPreferenceManager().registerOnActivityDestroyListener(this);

        // Create the dialog
        final Dialog dialog = mDialog = mBuilder.create();
        if (state != null) {
            dialog.onRestoreInstanceState(state);
        }
        if (needInputMethod()) {
            requestInputMethod(dialog);
        }
        dialog.setOnDismissListener(this);
        dialog.show();
    }

从上面代码中可以看出，如果 View contentView = onCreateDialogView();得到的contentView 是个null则Dialog为一个简短消息的Dialog，不为null还是个简短消息的Dialog，不过样式不同了。可继承DialogPreference，重写onCreateDialogView()方法来达到控制Dialog显示的目的。

 protected View onCreateDialogView() {
     if (mDialogLayoutResId == 0) {
         return null;
     }

     LayoutInflater inflater = (LayoutInflater) getContext().getSystemService(
             Context.LAYOUT_INFLATER_SERVICE);
     return inflater.inflate(mDialogLayoutResId, null);
 }

EditTextPreference：继承DialogPreference

重写了onPrepareDialogBuilder(mBuilder)方法，把Dialog的View部分变成了一个EditText。没有从写onPrepareDialogBuilder(mBuilder)方法，重写了onDialogClosed方法，代码如下：

 @Override
 protected void onDialogClosed(boolean positiveResult) {
     super.onDialogClosed(positiveResult);

     if (positiveResult) {
         String value = mEditText.getText().toString();
         if (callChangeListener(value)) {
             setText(value);
         }
     }
 }

从上面的代码可以看出，此方法被调时，如果参数 是true并且callChangeListener(value)返回true，则保存变化的值到配置文件中，当且仅当点击了确定按钮时才会传true。callChangeListener方法说明在CheckboxPreference部分。


ListPreference：继承DialogPreference

重写了onPrepareDialogBuilder与onDialogClosed方法，onPrepareDialogBuilder代码如下：

 @Override
    protected void onPrepareDialogBuilder(Builder builder) {
        super.onPrepareDialogBuilder(builder);

        if (mEntries == null || mEntryValues == null) {
            throw new IllegalStateException(
                    "ListPreference requires an entries array and an entryValues array.");
        }

        mClickedDialogEntryIndex = getValueIndex();
        builder.setSingleChoiceItems(mEntries, mClickedDialogEntryIndex,
                new DialogInterface.OnClickListener() {
                    public void onClick(DialogInterface dialog, int which) {
                        mClickedDialogEntryIndex = which;

                        /*
                         * Clicking on an item simulates the positive button
                         * click, and dismisses the dialog.
                         */
                        ListPreference.this.onClick(dialog, DialogInterface.BUTTON_POSITIVE);
                        dialog.dismiss();
                    }
        });

        /*
         * The typical interaction for list-based dialogs is to have
         * click-on-an-item dismiss the dialog instead of the user having to
         * press 'Ok'.
         */
        builder.setPositiveButton(null, null);
    }

代码比较容易懂。

onDialogClosed代码如下：

 @Override
    protected void onDialogClosed(boolean positiveResult) {
        super.onDialogClosed(positiveResult);

        if (positiveResult && mClickedDialogEntryIndex >= 0 && mEntryValues != null) {
            String value = mEntryValues[mClickedDialogEntryIndex].toString();
            if (callChangeListener(value)) {
                setValue(value);
            }
        }
    }

原理参见前面解释。