在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>
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);