标签：preference   偏好设置   

Preference 用来管理应用程序的偏好设置和保证使用这些的每个应用程序的所有参数 拥有同样的方式和用户体验   并且系统和其他应用程序的UI保持偏一致。

一个应用程序的偏好部分应作为一个独立的活动扩展preferenceactivity类 类中的对象应该是preferencescreen ，preferencescreen包含偏好等元素的布局的根元素 比如checkboxpreference EditTextPreference, ListPreference, PreferenceCategory, RingtonePreference.

对于一个给定的偏好设置将自动保存到SharedPreferences ， 拿到SharedPreferences应用实例的很简单getsharedpreferences（）；值的注意的是保存首选项只能由创建的应用程序去操作。

一般设置对应的UI如图

android 3.0以下版本，必须使用PreferenceActivity类来构建。  高于或等于android 3.0版本 使用PreferenceFragment。当然设备屏幕如果足够大的话还是可以使用PreferenceActivity创建双面板布局来显示多组设置

安卓给我们提供了一下接口：

1 Preference 可实现的接口

 interfacePreference.OnPreferenceChangeListener（偏好值已更改的用户和改变的时候 调用） 和Preference.OnPreferenceClickListener（偏好设置被点击的时候调用 ）

装载请标明出处：：http://blog.csdn.net/sk719887916

2.Preference元素的通用XML Attributes：    

android:key ：      key：唯一标识，SharedPreferences也将通过此Key值进行数据保存,也可以通过key值获取保存的信息 。          

android:defaultValue ： 默认值。 例如，CheckPreference的默认值可为”true”，默认为选中状态。

android:enabled ：      表示该Preference是否可用状态。     

android:title ：              每个Preference在PreferenceScreen布局上显示的标题——大标题  

android:summary ：      每个Preference在PreferenceScreen布局上显示的标题——小标题(可以没有)

android:persistent：    表示Preference元素所对应的值是否写入sharedPreferen文件中，如果是true，则表示写入；否则，则表示不写入该Preference元素的值。

android:layout：         在一个preferenceactivity的偏好布局 用于填充view

android:dependency：    表示一个Preference(用A表示)的可用状态依赖另外一个Preference(用B表示)。B可用，

                                              则A可用；B不可用，则A不可用。

android:icon:    偏好图标    对于偏好选择图标必须是一个引用到另一个资源的形式或以packagetypename 主题属性.

android:disableDependentsState：  与android:dependency相反。B可用，则A不可用；B不可用，则A可用。

android:order：表示偏好顺序，对于偏好较低的值的顺序是先点如果不指定默认的排序将字母必须是一个整数，如100，这也可能是一个参考值在含有这类这相当于全局属性资源符号秩序的形式或 形式packagetypename主题属性的一个资源。

android:shouldDisableView：是否被禁用，这种偏好是必须是布尔值true或false 这也可能是一个参考的形式或主题属性packagetypename资源，packagetypename形式包含一个值   相当于全局属性资源符号shoulddisableview相关方法

android:selectable：偏好是否是可选的。

android:fragment：  使用时，可以碎片化PreferenceActivity。

3.显示Preference布局结构的方法为：

           使我们的Activity继承PreferenceActivity，然后在onCreate()方法中通过   

      addPreferencesFromResource(R.xml.custom_preference) (我们自定义的Preference 布局)。

      怎么样，是不是似曾相识？稍后会用一个Demo来为您详述。

   常用的方法则包括：

                getKey()            setKey()

             getSummary()        setSummary()

             getText()           setText()

      getXXX()代表取得xxx属性的值。

  一个简易的效果图如下：

4.Preference的跳转：

     方法一：在配置每个Preference元素节点时，我们可以显示为点击它时所跳转的Intent。点击该Preference，跳转至目标Intent。除非在onPreferenceTreeClick()方法中进行抉择。在xml中配置如下：

</pre><pre name="code" class="java" style="font-size: 14px; color: rgb(34, 34, 34);">1.<Preference android:key="wifi_setting" android:title="Wi-Fi设置"  
2.    android:summary="设置和管理无线接入点" android:dependency="apply_wifi">  
3.    <!-- 点击时 自定义一个默认跳转Intent  action指定隐式Intent -->  
4.    <!-- action指定隐式Intent ; targetPackage和targetClass指定显示Intent-->  
5.    <intent android:action="com.feixun.action.seemAction"   
6.        android:targetPackage="com.feixun.qin" android:targetClass="com.feixun.qin.MainActivity" />  
7.</Preference>  

8. android:key 唯一标识符。它对应保存的XML保存的配置文件中的节点的 name属性

9. android:defaultValue 默认值，对应XML中的Value属性的值。

10. 

     方法二：可以在onPreferenceTreeClick()创建新的intent显示的进行跳转。

  接下来，对每个Preference的的独有XML Attributes和方法进行一下总结，使大家有更好的深入理解。

       1、EditPreference 

        可输入的设置项

            方法：

               getEditText()  返回的是我们在该控件中输入的文本框值

               getText()     返回的是我们之前sharedPreferen文件保存的值

        2、ListPreference

         多选对话框设置项

          XML Attributes：

              android:dialogTitle：弹出控件对话框时显示的标题

              android:entries：类型为array，控件欲显示的文本

              android:entryValues：类型为array，与文本相对应的key-value键值对，value保存至sharedPreference文件

              说明：entries和entryValue属性使用的数组为定义在资源文件arrays.xml的数组名：

          方法：

              CharSequence[]    getEntries()： 返回的是控件显示文本的一个”key”数组，对应于属性android:entries

              CharSequence[]    getEntryValues()：返回的一个”value”数组，对应于属性android: entryValues

              CharSequence      getEntry(): 返回当前选择文本

                String          getValue() :返回当前选中文本选中的value 。

       其实用法和对选对话框一致 只不过做了保存设置。

         采用的数组为：      

entries：列表中显示的值。为一个数组，通读通过资源文件进行设置。

entryValues：列表中实际保存的值，也entries对应。为一个数组，通读通过资源文件进行设置。以下代码显示的是arrays.xml文件中内容：

<resources>
<string-array name="department">
<item>春节</item>
<item>元旦</item>
<item>元宵</item>
</string-array>
<string-array name="department_value">
<item>001</item>
<item>002</item>
<item>003</item>
</string-array>
</resources>

   可点击的设置项

  4  dialogPreference

    弹出一个对话框 用户选择确定和取消 

 重点：分析Preference事件

      以下摘自网络：

------------------------------------------------------------------------------------

   ★在PreferenceActivity方法中，一个比较重要的监听点击事件方法为：

         public booleanonPreferenceTreeClick (PreferenceScreen preferenceScreen, Preference preference)

                           说 明 ： 当Preference控件被点击时，触发该方法。

           参数说明： preference 点击的对象。

           返回值：   true  代表点击事件已成功捕捉，无须执行默认动作或者返回上层调用链。 例如，不跳转至默认Intent。

                 false 代表执行默认动作并且返回上层调用链。例如，跳转至默认Intent。

      在我们继承PreferenceActivity的Activity可以重写该方法，来完成我们对Preference事件的捕捉。

     相信通过前面的介绍，你一定知道了如何使用了Preference家族并且对其触发方法。下面我们抛出另外两枚炸弹——

Preference相关的两个重要监听接口。

   ★  Preference.OnPreferenceChangeListener     该监听器的一个重要方法如下：

        boolean onPreferenceChange(Preference preference,Object objValue)

             说明：  当Preference的元素值发送改变时，触发该事件。

             返回值：true  代表将新值写入sharedPreference文件中。

                     false 则不将新值写入sharedPreference文件

  ★   Preference.OnPreferenceClickListener      该监听器的一个重要方法如下：

         public booleanonPreferenceClick(Preference preference)

             说明：当点击控件时触发发生，可以做相应操作。

    那么当一个Preference控件实现这两个接口时，当被点击或者值发生改变时，触发方法是如何执行的呢?事实上，

 它的触发规则如下：

      1 先调用onPreferenceClick()方法，如果该方法返回true，则不再调用onPreferenceTreeClick方法 ；

       如果onPreferenceClick方法返回false，则继续调用onPreferenceTreeClick方法。

      2 onPreferenceChange的方法独立与其他两种方法的运行。也就是说，它总是会运行。

补充：点击某个Preference控件后，会先回调onPreferenceChange()方法，即是否保存值，然后再回调onPreferenceClick以及onPreferenceTreeClick()方法，因此在onPreferenceClick/onPreferenceTreeClick

方法中我们得到的控件值就是最新的Preference控件值。

  那么，开始我们的实战之旅吧！ 下面给您最火热的战场。

    1，新建我们的preference.xml文件。

         ① 在res文件夹下，新建xml文件夹。

         ② 在新建的xml文件夹下，新建Android XML File。命名为mypeference.xml 。类型选择为Preference。

         ③ 打开我们的mypeference.xml，视图选择Structure。可以手动配置我们的布局文件。可选的Preference空间如下：

导出的xml文件：yourpageName"_prefenrences.xml

<?xml version='1.0' encoding='utf-8' standalone='yes' ?>
<map>
<boolean name="Apply_wireless" value="false" />
<boolean name="apply_fly" value="true" />
<boolean name="apply_bluetooth" value="true" />
<string name="number_edit2">123@baidu.com</string>
<boolean name="apply_wifi" value="true" />
<boolean name="apply_gps" value="true" />
<string name="number_edit">android.widget.EditText@41a45c00</string>
</map>

二、PreferenceFragment

PreferenceFragment可以在一屏幕放上多个SharedPreferences片段。实现多屏结构显示 ，pad用的居多 效果如下。

 用于显示层次结构的偏好对象列表   这些列表的选项将自动保存到SharedPreferences作为与用户交互以检索实例，在该片段SharedPreferences偏好的层次结构用默认的 sharedpreferences去拿值。

此外所示的偏好将遵循系统偏好视觉风格很容易创建一个层次结构鲜明的偏好，可以显示在多个屏幕上通过XML配置，由于这些原因，建议使用此片段作为一个父类的处理SharedPreferences。

PreferenceFragment偏好层次可以以多种方式形成。

@  从XML文件中指定的层次结构

@ 从不同的活动，可以指定自己的喜好 通过 XML文件的Activity meta-data中。

@从一个对象层次结构植根于preferencescreen.

代码示例：

<PreferenceScreen
        xmlns:android="http://schemas.android.com/apk/res/android">

    <PreferenceCategory
            android:title="显示一排偏好">

        <CheckBoxPreference
                android:key="checkbox_preference"
                android:title="开关"
                android:summary="@string/summary_checkbox_preference" />

    </PreferenceCategory>

    <PreferenceCategory
            android:title="这是对画框偏好">

        <EditTextPreference
                android:key="edittext_preference"
                android:title="@string/title_edittext_preference"
                android:summary="@string/summary_edittext_preference"
                android:dialogTitle="@string/dialog_title_edittext_preference" />

        <ListPreference
                android:key="list_preference"
                android:title="@string/title_list_preference"
                android:summary="@string/summary_list_preference"
                android:entries="@array/entries_list_preference"
                android:entryValues="@array/entryvalues_list_preference"
                android:dialogTitle="@string/dialog_title_list_preference" />

    </PreferenceCategory>

    <PreferenceCategory
            android:title="@string/launch_preferences">

        <!--这个标签作为一个屏幕preferencescreen打破类似于分页符在字处理像其他偏好类型我们分配一个关键在这里能够很好的保存和恢复它的实例的状态. 就是所谓的同属一个一样的类别<pre name="code" class="java" style="color: rgb(34, 34, 34); font-size: 14px; line-height: 19px;"><span style="font-family: Roboto, sans-serif;">--></span>

    <!-- 可以定义一个子sp 包括自己视觉风格和主题的  以下俩个子选项属于同一个类别-->

java 代码可以这样写;

public static class PrefsFragment extends PreferenceFragment {

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        // 加载布局
        addPreferencesFromResource(R.xml.preferences);
    }
}

addPreferencesFromResource (int preferencesResId)

 2 每个意图可以指定清单中的元数据通过Key来获取子Preference    ，

3 PreferenceGroup

5 SwitchPreference

安卓Preference详解

标签：preference   偏好设置   

原文地址：http://blog.csdn.net/sk719887916/article/details/42437253