Android中Preference的使用以及監聽事件分析

在Android系統源碼中,絕大多數應用程序的UI佈局採用了Preference的佈局結構,而不是我們平時在模擬器中構建應用程序時使用的View 佈局結構,例如,Setting模塊中佈局。當然,凡事都有例外,FMRadio應用程序中則使用了View佈局結構(可能是該應用程序是marvel公 司提供的,如果由google公司做,那可說不準)。歸根到底,Preference佈局結構和View的佈局結構本質上還是大同小 異,Preference的優點在於佈局界面的可控性和高效率以及可存儲值的簡潔性(每個PreferenPreferencece存儲在相對應下的 SharedPreference文件夾下)。 下面,我們對比Preference和View下得各個子控件,對他們的家庭元素在宏觀上有個更好的把握性。

 

單一控件:

    Preference 控件家庭     View控件家庭         控件含義

    Preferenc           TextView               文本框  

    CheckPreference                 CheckBox              單選框

    EditTextPreference             EditText              輸入文本框 

    ListPreference                    ListView             列表框

    RingtonePreference            ——                   鈴聲

  其實在Android源碼系統中還有很多的”未完工”的Preference, 沒有爲它們提供PI接口,例如SeekBarPreference,有興趣的同學可以參考源碼,具體路徑爲:frameworks/base/core/java/preference。

 

組合控件:

  PreferenceCategory :類似於LinearLayou、RelativeLayout,用於組合一組Preference,使佈局更具備層次感 。

  PreferenceScreen  : 所有Preference元素的根節點。

 

顯示Preference佈局結構的方法爲:

  使我們的Activity繼承PreferenceActivity,然後在onCreate()方法中通過 addPreferencesFromResource(R.xml.custom_preference) (我們自定義的Preference 佈局)。

  怎麼樣,是不是似曾相識?稍後會用一個Demo來爲您詳述。

 

Preference元素的通用XML Attributes說明:    

  android:key :          每個Preference控件獨一無二的”ID”,唯一表示此Preference。          

  android:defaultValue : 默認值。 例如,CheckPreference的默認值可爲”true”,默認爲選中狀態;

                                              EditTextPreference的默認值可爲”110” 。

  android:enabled :      表示該Preference是否可用狀態。     

  android:title :        每個Preference在PreferenceScreen佈局上顯示的標題——大標題

  android:summary :      每個Preference在PreferenceScreen佈局上顯示的標題——小標題(可以沒有)

  android:persistent:    表示Preference元素所對應的值是否寫入sharedPreferen文件中,如果是true,則表示寫

                                        入;否則,則表示不寫入該Preference元素的值。

  android:dependency:    表示一個Preference(用A表示)的可用狀態依賴另外一個Preference(用B表示)。B可用,

                                               則A可用;B不可用,則A不可用。

   android:disableDependentsState:  與android:dependency相反。B可用,則A不可用;B不可用,則A可用。

 常用的方法則包括:

    getKey()              setKey()

             getSummary()    setSummary()

             getText()             setText()

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

 

  一個簡易的效果圖如下:

 

     

  

Preference的跳轉:

   方法一:在配置每個Preference元素節點時,我們可以顯示爲點擊它時所跳轉的Intent。點擊該Preference,跳轉至目標Intent。除非在onPreferenceTreeClick()方法中進行抉擇。在xml中配置如下:

 

複製代碼
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>  
複製代碼

   方法二:可以在onPreferenceTreeClick()創建新的intent顯示的進行跳轉。

 

Preference的Attributes和方法

  接下來,對每個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 。

     與之對應的還有它們所對應的setXXX()方法,可以參考SDK進行分析。效果圖:

 

                                  

 

         採用的數組爲:      

 

複製代碼
 1     <?xml version="1.0" encoding="utf-8"?>  
 2     <resources>  
 3         <string-array name="department">  
 4             <item>IT</item>  
 5             <item>Commerce</item>  
 6             <item>HR</item>  
 7         </string-array>  
 8         <string-array name="department_value">  
 9             <item>001</item>  
10             <item>002</item>  
11             <item>003</item>  
12         </string-array>  
13     </resources>  
複製代碼

 

3、RingtonePreference

  XML Attributes:

    android:ringtoneType:響鈴的鈴聲類型,主要有:ringtone(音樂)、notification(通知)、alarm(鬧鈴)

                                      、all(所有可用聲 音類型)。

    android:showDefault :默認鈴聲,可以使用系統(布爾值---true,false)的或者自定義的鈴聲

    android:showSilent  :指定鈴聲是否爲靜音。指定鈴聲包括系統默認鈴聲或者自定義的鈴聲

  效果圖:

                 

 

重點:分析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的方法獨立與其他兩種方法的運行。也就是說,它總是會運行。

 

  那麼,開始我們的實戰之旅吧! 下面給您最火熱的戰場。

  1,新建我們的preference.xml文件。

         ① 在res文件夾下,新建xml文件夾。

         ② 在新建的xml文件夾下,新建Android XML File。命名爲mypeference.xml 。類型選擇爲Preference。

         ③ 打開我們的mypeference.xml,視圖選擇Structure。可以手動配置我們的佈局文件。可選的Preference空間如下:

               

   Demo中mypeference.xml的佈局文件如下: 

 

複製代碼
 1 <?xml version="1.0" encoding="utf-8"?>  
 2 <PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">  
 3   
 4     <PreferenceCategory android:title="我的位置"  
 5         android:key="set_local" />  
 6     <CheckBoxPreference android:key="apply_wireless"  
 7         android:title="使用無線網絡" android:summary="使用無線網絡在應用程序(例如Google地圖)中查看位置"  
 8         android:defaultValue="true">  
 9     </CheckBoxPreference>  
10     <CheckBoxPreference android:key="apply_gps"  
11         android:title="使用GPS" android:summary="定位到街道級別(需要消耗更多的電量以及天氣允許)">  
12     </CheckBoxPreference>  
13   
14     <PreferenceCategory android:title="無線和網絡設置"></PreferenceCategory>  
15   
16     <CheckBoxPreference android:key="apply_fly"   
17         android:title="飛行模式" android:summary="禁用所有無線連接" >  
18     </CheckBoxPreference>  
19   
20     <CheckBoxPreference android:key="apply_internet"  
21         android:title="Internet共享" android:summary="禁用通過USB共享Internet連接">  
22     </CheckBoxPreference>  
23   
24     <CheckBoxPreference android:key="apply_wifi"  
25         android:title="Wi-Fi" android:summary="打開Wi-Fi">  
26     </CheckBoxPreference>  
27     <Preference android:key="wifi_setting" android:title="Wi-Fi設置"  
28         android:summary="設置和管理無線接入點" android:dependency="apply_wifi">  
29         <!-- 點擊時 自定義一個默認跳轉Intent  action指定隱式Intent -->  
30         <!-- action指定隱式Intent ; targetPackage和targetClass指定顯示Intent-->  
31         <intent android:action="com.feixun.action.seemAction"   
32             android:targetPackage="com.feixun.qin" android:targetClass="com.feixun.qin.MainActivity" />  
33     </Preference>  
34     <CheckBoxPreference android:key="apply_bluetooth"  
35         android:title="藍牙" android:summary="啓用藍牙">  
36     </CheckBoxPreference>  
37     <Preference android:key="bluetooth_setting" android:title="藍牙設置"  
38         android:summary="管理連接、設備設備名稱和可檢測性" android:dependency="apply_bluetooth">  
39     </Preference>  
40     <EditTextPreference android:key="number_edit"  
41         android:title="輸入電話號碼" android:defaultValue="123">  
42     </EditTextPreference>  
43     <ListPreference android:key="depart_value"  
44         android:title="部門設置" android:dialogTitle="選擇部門" android:entries="@array/department"  
45         android:entryValues="@array/department_value">  
46     </ListPreference>  
47     <RingtonePreference android:key="ring_key"  
48         android:title="鈴聲" android:ringtoneType="all" android:showDefault="true"  
49         android:showSilent="true">  
50     </RingtonePreference>  
51 </PreferenceScreen>
複製代碼

 

 

2,新建一個HelloActivity繼承PreferenceActivity,代碼如下:  

 

複製代碼
  1     package com.feixun.qin;  
  2       
  3     import android.content.Intent;  
  4     import android.content.SharedPreferences;  
  5     import android.os.Bundle;  
  6     import android.preference.CheckBoxPreference;  
  7     import android.preference.EditTextPreference;  
  8     import android.preference.ListPreference;  
  9     import android.preference.Preference;  
 10     import android.preference.PreferenceActivity;  
 11     import android.preference.PreferenceManager;  
 12     import android.preference.PreferenceScreen;  
 13     import android.preference.Preference.OnPreferenceClickListener;  
 14     import android.util.Log;  
 15       
 16     public class HelloPreference extends PreferenceActivity implements  
 17             Preference.OnPreferenceClickListener,  
 18             Preference.OnPreferenceChangeListener {  
 19         private static String TAG = "HelloPreference";            
 20         private CheckBoxPreference mapply_wifiPreference;       //打開wifi  
 21         private CheckBoxPreference mapply_internetPreference;   //Internet共享  
 22         private ListPreference depart_valuePreference;          //部門設置  
 23         private EditTextPreference number_editPreference;       //輸入電話號碼  
 24         private Preference mwifi_settingPreference;             //wifi設置  
 25         private String oldDeptId; // 舊部門的名稱  
 26       
 27         public void onCreate(Bundle savedInstanceState) {  
 28             super.onCreate(savedInstanceState);  
 29             addPreferencesFromResource(R.xml.mypreference);  
 30             //根據key值找到控件  
 31             mapply_wifiPreference = (CheckBoxPreference) findPreference("apply_wifi");  
 32             mapply_internetPreference = (CheckBoxPreference) findPreference("apply_internet");  
 33             depart_valuePreference = (ListPreference) findPreference("depart_value");  
 34             number_editPreference = (EditTextPreference) findPreference("number_edit");  
 35             mwifi_settingPreference = (Preference) findPreference("wifi_setting");  
 36       
 37             // 設置監聽器  
 38             mapply_internetPreference.setOnPreferenceClickListener(this);  
 39             mapply_internetPreference.setOnPreferenceChangeListener(this);  
 40             depart_valuePreference.setOnPreferenceClickListener(this);  
 41             depart_valuePreference.setOnPreferenceChangeListener(this);  
 42             number_editPreference.setOnPreferenceClickListener(this);  
 43             number_editPreference.setOnPreferenceChangeListener(this);  
 44             mwifi_settingPreference.setOnPreferenceClickListener(this);  
 45       
 46             // 得到我們的存儲Preferences值的對象,然後對其進行相應操作  
 47             SharedPreferences shp = PreferenceManager.getDefaultSharedPreferences(this);  
 48             boolean apply_wifiChecked = shp.getBoolean("apply_wifi", false);  
 49         }  
 50       
 51         // 對控件進行的一些操作  
 52         private void operatePreference(Preference preference) {  
 53             if (preference == mapply_wifiPreference){                  //點擊了    "打開wifi"  
 54                 Log.i(TAG, " Wifi CB, and isCheckd ="+ mapply_wifiPreference.isChecked());  
 55             }else if (preference.getKey().equals("apply_internet")){   //點擊了"Internet共享"  
 56                 Log.i(TAG, " internet CB, and isCheckd = "+mapply_internetPreference.isChecked());  
 57             }else if (preference == depart_valuePreference){           //點擊了 "部門設置"  
 58                 Log.i(TAG, " department CB,and selectValue = "+ depart_valuePreference.getValue() + ", Text="+ depart_valuePreference.getEntry());  
 59             }else if (preference.getKey().equals("wifi_setting")) {    //點擊了"wifi設置"  
 60                 mwifi_settingPreference.setTitle("its turn me.");  
 61             }else if (preference == number_editPreference)             //點擊了"輸入電話號碼"  
 62                 Log.i(TAG, "Old Value="+ number_editPreference.getText() + ", New Value="+ number_editPreference.getEditText().toString());  
 63         }  
 64         // 點擊事件觸發  
 65         @Override  
 66         public boolean onPreferenceClick(Preference preference) {  
 67             // TODO Auto-generated method stub  
 68             Log.i(TAG, "onPreferenceClick----->"+String.valueOf(preference.getKey()));  
 69             // 對控件進行操作  
 70             operatePreference(preference);  
 71             return false;  
 72         }  
 73             //點擊事件觸發  
 74         public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen,  
 75                 Preference preference) {  
 76             Log.i(TAG, "onPreferenceTreeClick----->"+preference.getKey());  
 77             // 對控件進行操作  
 78             operatePreference(preference);  
 79             if (preference.getKey().equals("wifi_setting")) {  
 80                 // 創建一個新的Intent,  
 81                 // 函數如果返回true, 則跳轉至該自定義的新的Intent ;  
 82                 // 函數如果返回false,則跳轉至xml文件中配置的Intent ;  
 83                 Intent i = new Intent(HelloPreference.this, OtherActivity.class);  //OtherActivity只是一個簡單的Activity  
 84                 i.putExtra("type", "wifi");  
 85                 startActivity(i);  
 86                 return true;  
 87             }  
 88             return false;  
 89         }  
 90       
 91         // 當Preference的值發生改變時觸發該事件,true則以新值更新控件的狀態,false則do noting  
 92         public boolean onPreferenceChange(Preference preference, Object objValue) {  
 93             Log.i(TAG, "onPreferenceChange----->"+String.valueOf(preference.getKey()));  
 94             if (preference == mapply_wifiPreference){  
 95                 Log.i(TAG, "Wifi CB, and isCheckd = " + String.valueOf(objValue));  
 96             }else if (preference.getKey().equals("apply_internet")) {  
 97                 Log.i(TAG, "internet CB, and isCheckd = "+ String.valueOf(objValue));  
 98                 return false;  //不保存該新值  
 99             }else if (preference == depart_valuePreference){  
100                 Log.i(TAG, "  Old Value"+ depart_valuePreference.getValue()+" NewDeptName"+objValue);  
101             }else if (preference.getKey().equals("wifi_setting")) {  
102                 Log.i(TAG, "change" + String.valueOf(objValue));  
103                 mwifi_settingPreference.setTitle("its turn me.");  //重新設置title  
104             } else if (preference == number_editPreference) {  
105                 Log.i(TAG, "Old Value = " + String.valueOf(objValue));  
106                 return false; // 不保存更新值  
107             }  
108             return true;  //保存更新後的值  
109         }  
110     }  
複製代碼

 

3,AndroidManifest 文件如下:

 

複製代碼
 1     <?xml version='1.0' encoding='utf-8' standalone='yes' ?>  
 2       
 3     <map>  
 4       
 5     <boolean name="apply_wifi" value="true" />  
 6       
 7     <boolean name="apply_internet" value="true" />  
 8       
 9     <string name="number_edit">45677</string>  
10     <string name="ring_key">content://settings/system/ringtone</string>  
11       
12     <boolean name="apply_bluetooth" value="true" />  
13       
14     <boolean name="apply_fly" value="true" />  
15       
16     <string name="depart_value">001</string>  
17       
18     <boolean name="apply_gps" value="true" />  
19       
20     <boolean name="apply_wireless" value="false" />  
21       
22     </map>  
複製代碼

 

程序運行後,效果如上所示,是不是很給力呀! 

 

sharedPreference文件

  前面我們說過,Android系統會將Preference元素的值存儲在sharedPreference文件中。該文件存放路徑位於DDMS視圖下的data/data/[packgename]/shared_prefs/文件下,命名約定爲:packagename_preferencse.xml。我們的com.feixun.qin_preferences.xm保存的值爲:

 

 

複製代碼
 1     <?xml version='1.0' encoding='utf-8' standalone='yes' ?>  
 2       
 3     <map>  
 4       
 5     <boolean name="apply_wifi" value="true" />  
 6       
 7     <boolean name="apply_internet" value="true" />  
 8       
 9     <string name="number_edit">45677</string>  
10     <string name="ring_key">content://settings/system/ringtone</string>  
11       
12     <boolean name="apply_bluetooth" value="true" />  
13       
14     <boolean name="apply_fly" value="true" />  
15       
16     <string name="depart_value">001</string>  
17       
18     <boolean name="apply_gps" value="true" />  
19       
20     <boolean name="apply_wireless" value="false" />  
21       
22     </map>  
複製代碼

 

  以一個鍵值對的形式保存,name爲Preference的key值,value爲Preference的value值。

  

  在應用程序中,我們可以通過代碼的方式來訪問該sharedPreference文件,繼而可以對其進行讀取甚至任何操作。

      代碼如下: 

 

1     // 得到我們的存儲Preferences值的對象,然後對其進行相應操作  
2     SharedPreferences shp = PreferenceManager.getDefaultSharedPreferences(this);  
3     boolean apply_wifiChecked = shp.getBoolean("apply_wifi", false);  

 

發佈了4 篇原創文章 · 獲贊 5 · 訪問量 3萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章