Android中Preference的使用以及監聽事件分析
在Android系統原始碼中,絕大多數應用程式的UI佈局採用了Preference的佈局結構,而不是我們平時在模擬器中構建應用程式時使用的View佈局結構,例如,Setting模組中佈局。當然,凡事都有例外,FMRadio應用程式中則使用了View佈局結構(可能是該應用程式是marvel公司提供的,如果由google公司做,那可說不準)。歸根到底,Preference佈局結構和View的佈局結構本質上還是大同小異,Preference的優點在於佈局介面的可控性和高效率以及可儲存值的簡潔性(每個PreferenPreferencece儲存在相對應下的SharedPreference資料夾下)。 下面,我們對比Preference和View下得各個子控制元件,對他們的家庭元素在巨集觀上有個更好的把握性。
單一控制元件:
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 佈局)。
怎麼樣,是不是似曾相識?稍後會用一個Demo來為您詳述。
Preference元素的通用XML Attributes說明:
android:key : 每個Preference控制元件獨一無二的”ID”,唯一表示此Preference。
android:defaultValue : 預設值。 例如,CheckPreference的預設值可為”true”,預設為選中狀態;
EditTextPreference的預設值可為”110” 。
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.feixun.action.seemAction"
android:targetPackage="com.feixun.qin" android:targetClass="com.feixun.qin.MainActivity" />
</Preference>
方法二:可以在onPreferenceTreeClick()建立新的intent顯示的進行跳轉。
接下來,對每個Preference的的獨有XML Attributes和方法進行一下總結,使大家有更好的深入理解。
1、EditPreference
方法:
getEditText() 返回的是我們在該控制元件中輸入的文字框值
getText() 返回的是我們之前sharedPreferen檔案儲存的值
效果圖:
2、ListPreference
XML Attributes:
android:dialogTitle:彈出控制元件對話方塊時顯示的標題
android:entryValues:型別為array,與文字相對應的key-value鍵值對,value儲存至sharedPreference檔案
說明:entries和entryValue屬性使用的陣列為定義在資原始檔arrays.xml的陣列名:
方法:
String getValue() :返回當前選中文字選中的value 。
與之對應的還有它們所對應的setXXX()方法,可以參考SDK進行分析。效果圖:
採用的陣列為:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string-array name="department">
<item>IT</item>
<item>Commerce</item>
<item>HR</item>
</string-array>
<string-array name="department_value">
<item>001</item>
<item>002</item>
<item>003</item>
</string-array>
</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的方法獨立與其他兩種方法的執行。也就是說,它總是會執行。
補充:點選某個Preference控制元件後,會先回調onPreferenceChange()方法,即是否儲存值,然後再回 調onPreferenceClick以及onPreferenceTreeClick()方法,因此在onPreferenceClick/onPreferenceTreeClick
方法中我們得到的控制元件值就是最新的Preference控制元件值。
那麼,開始我們的實戰之旅吧! 下面給您最火熱的戰場。
1,新建我們的preference.xml檔案。
① 在res資料夾下,新建xml資料夾。
② 在新建的xml資料夾下,新建Android XML File。命名為mypeference.xml 。型別選擇為Preference。
③ 開啟我們的mypeference.xml,檢視選擇Structure。可以手動配置我們的佈局檔案。可選的Preference空間如下:
Demo中mypeference.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>
2,新建一個HelloActivity繼承PreferenceActivity,程式碼如下:
package com.feixun.qin;
import android.content.Intent;
import android.content.SharedPreferences;
import android.os.Bundle;
import android.preference.CheckBoxPreference;
import android.preference.EditTextPreference;
import android.preference.ListPreference;
import android.preference.Preference;
import android.preference.PreferenceActivity;
import android.preference.PreferenceManager;
import android.preference.PreferenceScreen;
import android.preference.Preference.OnPreferenceClickListener;
import android.util.Log;
public class HelloPreference extends PreferenceActivity implements
Preference.OnPreferenceClickListener,
Preference.OnPreferenceChangeListener {
private static String TAG = "HelloPreference";
private CheckBoxPreference mapply_wifiPreference; //開啟wifi
private 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());
}
// 點選事件觸發
@Override
public boolean onPreferenceClick(Preference preference) {
// TODO Auto-generated method stub
Log.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只是一個簡單的Activity
i.putExtra("type", "wifi");
startActivity(i);
return true;
}
return false;
}
// 當Preference的值發生改變時觸發該事件,true則以新值更新控制元件的狀態,false則do noting
public 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; //儲存更新後的值
}
}
3,AndroidManifest 檔案如下:
<?xml version='1.0' encoding='utf-8' standalone='yes' ?>
<map>
<boolean name="apply_wifi" value="true" />
<boolean name="apply_internet" value="true" />
<string name="number_edit">45677</string>
<string name="ring_key">content://settings/system/ringtone</string>
<boolean name="apply_bluetooth" value="true" />
<boolean name="apply_fly" value="true" />
<string name="depart_value">001</string>
<boolean name="apply_gps" value="true" />
<boolean name="apply_wireless" value="false" />
</map>
程式執行後,效果如上所示,是不是很給力呀!
sharedPreference檔案
前面我們說過,Android系統會將Preference元素的值儲存在sharedPreference檔案中。該檔案存放路徑位於
DDMS檢視下的data/data/[packgename]/shared_prefs/檔案下,命名約定為:packagename_preferencse.xml。
我們的com.feixun.qin_preferences.xm儲存的值為:
<?xml version='1.0' encoding='utf-8' standalone='yes' ?>
<map>
<boolean name="apply_wifi" value="true" />
<boolean name="apply_internet" value="true" />
<string name="number_edit">45677</string>
<string name="ring_key">content://settings/system/ringtone</string>
<boolean name="apply_bluetooth" value="true" />
<boolean name="apply_fly" value="true" />
<string name="depart_value">001</string>
<boolean name="apply_gps" value="true" />
<boolean name="apply_wireless" value="false" />
</map>
已一個鍵值對的形式儲存,name為Preference的key值,value為Preference的value值。
在應用程式中,我們可以通過程式碼的方式來訪問該sharedPreference檔案,繼而可以對其進行讀取甚至任何操作。
程式碼如下:
// 得到我們的儲存Preferences值的物件,然後對其進行相應操作
SharedPreferences shp = PreferenceManager.getDefaultSharedPreferences(this);
boolean apply_wifiChecked = shp.getBoolean("apply_wifi", false);
就介紹到這兒了 。