Android Prefence 总结
PreferenceActivity通常用在設置界面,用于保存設置的狀態數據。在Android系統源碼中,絕大多數應用程序的UI布局采用了Preference的布局結構,而不是我們平時在模擬器中構建應用程序時使用的View布局結構,例如,Setting模塊中布局。Preference布局結構和View的布局結構本質上還是大同小異,Preference的優點在于布局界面的可控性和高效率以及可存儲值的簡潔性(每個PreferenPreferencece存儲在相對應下的SharedPreference文件夾下)。?下面,我們對比Preference和View下得各個子控件,對他們的家庭元素在宏觀上有個更好的把握性。
?
? 在應用程序中,我們可以通過代碼的方式來訪問該sharedPreference文件,繼而可以對其進行讀取甚至任何操作。代碼如下:?
//?得到我們的存儲Preferences值的對象,然后對其進行相應操作??
SharedPreferences?shp?=?PreferenceManager.getDefaultSharedPreferences(this);??
boolean?apply_wifiChecked?=?shp.getBoolean("apply_wifi",?false);
?
文件保存路徑:Android系統會將Preference元素的值存儲在sharedPreference文件中。該文件位于data/data/[packgename]/shared_prefs/文件下,命名約定為:packagename_preferencse.xml。
?
控件含義???????? Preference?控件家庭?????????View控件家庭???????
文本框????????????? Preference??????????????????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?布局)。
?
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中配置如下:
<Preference?android:key="wifi_setting"?android:title="Wi-Fi設置"??
????android:summary="設置和管理無線接入點"?android:dependency="apply_wifi">??
????<!--?點擊時?自定義一個默認跳轉Intent??action指定隱式Intent?-->??
????<!--?action指定隱式Intent?;?targetPackage和targetClass指定顯示Intent-->??
????<intent?android:action="com.xsl.seemAction"?android:targetPackage="com.xsl.qin"?android:targetClass="com.xsl.qin.MainActivity"?/>??
</Preference>
方法二:可以實現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?。
與之對應的還有它們所對應的setXXX()方法,可以參考SDK進行分析。
3、RingtonePreference
XML?Attributes:
android:ringtoneType:響鈴的鈴聲類型,主要有:ringtone(音樂)、notification(通知)、alarm(鬧鈴)、all(所有可用聲?音類型)。
?? android:showDefault?:默認鈴聲,可以使用系統(布爾值---true,false)的或者自定義的鈴聲
?? android:showSilent??:指定鈴聲是否為靜音。指定鈴聲包括系統默認鈴聲或者自定義的鈴聲
?
分析Preference事件
? 在PreferenceActivity方法中,一個比較重要的監聽點擊事件方法為:
/*?說?明?:?當Preference控件被點擊時,觸發該方法。
?????*?參數說明:?preference???點擊的對象。
?????*?返回值:???true??代表點擊事件已成功捕捉,無須執行默認動作或者返回上層調用鏈。例如,不跳轉至默認Intent。?false?代表執行默認動作并且返回上層調用鏈。例如,跳轉至默認Intent。
?????*/
public?boolean?onPreferenceTreeClick(PreferenceScreen?preferenceScreen,?Preference?preference)
?
Preference相關的兩個重要監聽接口。
??? Preference.OnPreferenceChangeListener? 該監聽器的一個重要方法如下:
???/*
?*?說明:??當Preference的元素值發送改變時,觸發該事件。
?*?返回值:true??代表將新值寫入sharedPreference文件中。?false?則不將新值寫入sharedPreference文件
?*/
boolean?onPreferenceChange(Preference?preference,Object?objValue)
?
?? Preference.OnPreferenceClickListener??????該監聽器的一個重要方法如下:
????/*
?*?說明:當點擊控件時觸發發生,可以做相應操作。
?*/
public?boolean?onPreferenceClick(Preference?preference)??????????????????
????那么當一個Preference控件實現這兩個接口時,當被點擊或者值發生改變時,觸發方法是如何執行的呢?事實上,
觸發規則如下:
??????1.先調用onPreferenceClick()方法,如果該方法返回true,則不再調用onPreferenceTreeClick方法;
???????如果onPreferenceClick方法返回false,則繼續調用onPreferenceTreeClick方法。
??????2.onPreferenceChange的方法獨立與其他兩種方法的運行。也就是說,它總是會運行。
?
??????補充:點擊某個Preference控件后,會先回調onPreferenceChange()方法,即是否保存值,然后再回調onPreferenceClick以及onPreferenceTreeClick()方法,因此在onPreferenceClick/??onPreferenceTreeClick方法中我們得到的控件值就是最新的Preference控件值。
public class HelloPreference extends PreferenceActivity implementsPreference.OnPreferenceClickListener,Preference.OnPreferenceChangeListener {private static String TAG = "HelloPreference";private CheckBoxPreference mapply_wifiPreference; //打開wifiprivate CheckBoxPreference mapply_internetPreference; //Internet共享private ListPreference depart_valuePreference; //部門設置private EditTextPreference number_editPreference; //輸入電話號碼private Preference mwifi_settingPreference; //wifi設置private String oldDeptId; // 舊部門的名稱public void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);addPreferencesFromResource(R.xml.mypreference);//根據key值找到控件mapply_wifiPreference = (CheckBoxPreference) findPreference("apply_wifi");mapply_internetPreference = (CheckBoxPreference) findPreference("apply_internet");depart_valuePreference = (ListPreference) findPreference("depart_value");number_editPreference = (EditTextPreference) findPreference("number_edit");mwifi_settingPreference = (Preference) findPreference("wifi_setting");// 設置監聽器mapply_internetPreference.setOnPreferenceClickListener(this);mapply_internetPreference.setOnPreferenceChangeListener(this);depart_valuePreference.setOnPreferenceClickListener(this);depart_valuePreference.setOnPreferenceChangeListener(this);number_editPreference.setOnPreferenceClickListener(this);number_editPreference.setOnPreferenceChangeListener(this);mwifi_settingPreference.setOnPreferenceClickListener(this);// 得到我們的存儲Preferences值的對象,然后對其進行相應操作SharedPreferences shp = PreferenceManager.getDefaultSharedPreferences(this);boolean apply_wifiChecked = shp.getBoolean("apply_wifi", false);}// 對控件進行的一些操作private void operatePreference(Preference preference) {if (preference == mapply_wifiPreference){ //點擊了 "打開wifi"Log.i(TAG, " Wifi CB, and isCheckd ="+ mapply_wifiPreference.isChecked());}else if (preference.getKey().equals("apply_internet")){ //點擊了"Internet共享"Log.i(TAG, " internet CB, and isCheckd = "+mapply_internetPreference.isChecked());}else if (preference == depart_valuePreference){ //點擊了 "部門設置"Log.i(TAG, " department CB,and selectValue = "+ depart_valuePreference.getValue() + ", Text="+ depart_valuePreference.getEntry());}else if (preference.getKey().equals("wifi_setting")) { //點擊了"wifi設置"mwifi_settingPreference.setTitle("its turn me.");}else if (preference == number_editPreference) //點擊了"輸入電話號碼"Log.i(TAG, "Old Value="+ number_editPreference.getText() + ", New Value="+ number_editPreference.getEditText().toString());}// 點擊事件觸發@Overridepublic boolean onPreferenceClick(Preference preference) {// TODO Auto-generated method stubLog.i(TAG, "onPreferenceClick----->"+String.valueOf(preference.getKey()));// 對控件進行操作operatePreference(preference);return false;}//點擊事件觸發public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen,Preference preference) {Log.i(TAG, "onPreferenceTreeClick----->"+preference.getKey());// 對控件進行操作operatePreference(preference);if (preference.getKey().equals("wifi_setting")) {// 創建一個新的Intent,// 函數如果返回true, 則跳轉至該自定義的新的Intent ;// 函數如果返回false,則跳轉至xml文件中配置的Intent ;Intent i = new Intent(HelloPreference.this, OtherActivity.class); //OtherActivity只是一個簡單的Activityi.putExtra("type", "wifi");startActivity(i);return true;}return false;}// 當Preference的值發生改變時觸發該事件,true則以新值更新控件的狀態,false則do notingpublic boolean onPreferenceChange(Preference preference, Object objValue) {Log.i(TAG, "onPreferenceChange----->"+String.valueOf(preference.getKey()));if (preference == mapply_wifiPreference){Log.i(TAG, "Wifi CB, and isCheckd = " + String.valueOf(objValue));}else if (preference.getKey().equals("apply_internet")) {Log.i(TAG, "internet CB, and isCheckd = "+ String.valueOf(objValue));return false; //不保存該新值}else if (preference == depart_valuePreference){Log.i(TAG, " Old Value"+ depart_valuePreference.getValue()+" NewDeptName"+objValue);}else if (preference.getKey().equals("wifi_setting")) {Log.i(TAG, "change" + String.valueOf(objValue));mwifi_settingPreference.setTitle("its turn me."); //重新設置title} else if (preference == number_editPreference) {Log.i(TAG, "Old Value = " + String.valueOf(objValue));return false; // 不保存更新值}return true; //保存更新后的值} }Demo中preference.xml的布局文件如下: <?xml version="1.0" encoding="utf-8"?> <PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"><PreferenceCategory android:title="我的位置"android:key="set_local" /><CheckBoxPreference android:key="apply_wireless"android:title="使用無線網絡" android:summary="使用無線網絡在應用程序(例如Google地圖)中查看位置"android:defaultValue="true"></CheckBoxPreference><CheckBoxPreference android:key="apply_gps"android:title="使用GPS" android:summary="定位到街道級別(需要消耗更多的電量以及天氣允許)"></CheckBoxPreference><PreferenceCategory android:title="無線和網絡設置"></PreferenceCategory><CheckBoxPreference android:key="apply_fly"android:title="飛行模式" android:summary="禁用所有無線連接" ></CheckBoxPreference><CheckBoxPreference android:key="apply_internet"android:title="Internet共享" android:summary="禁用通過USB共享Internet連接"></CheckBoxPreference><CheckBoxPreference android:key="apply_wifi"android:title="Wi-Fi" android:summary="打開Wi-Fi"></CheckBoxPreference><Preference android:key="wifi_setting" android:title="Wi-Fi設置"android:summary="設置和管理無線接入點" android:dependency="apply_wifi"><!-- 點擊時 自定義一個默認跳轉Intent action指定隱式Intent --><!-- action指定隱式Intent ; targetPackage和targetClass指定顯示Intent--><intent android:action="com.feixun.action.seemAction"android:targetPackage="com.feixun.qin" android:targetClass="com.feixun.qin.MainActivity" /></Preference><CheckBoxPreference android:key="apply_bluetooth"android:title="藍牙" android:summary="啟用藍牙"></CheckBoxPreference><Preference android:key="bluetooth_setting" android:title="藍牙設置"android:summary="管理連接、設備設備名稱和可檢測性" android:dependency="apply_bluetooth"></Preference><EditTextPreference android:key="number_edit"android:title="輸入電話號碼" android:defaultValue="123"></EditTextPreference><ListPreference android:key="depart_value"android:title="部門設置" android:dialogTitle="選擇部門" android:entries="@array/department"android:entryValues="@array/department_value"></ListPreference><RingtonePreference android:key="ring_key"android:title="鈴聲" android:ringtoneType="all" android:showDefault="true"android:showSilent="true"></RingtonePreference> </PreferenceScreen>
轉載于:https://www.cnblogs.com/DswCnblog/archive/2012/10/24/2737136.html
總結
以上是生活随笔為你收集整理的Android Prefence 总结的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 三只松鼠app
- 下一篇: android sina oauth2.