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

時間 2019-11-06

標籤 android preference 使用以及監聽事件分析欄目 Android 简体版

原文原文鏈接

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

單一控件：

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

Preference TextView 文本框web

CheckPreference CheckBox 單選框數組

EditTextPreference EditText 輸入文本框網絡

ListPreference ListView 列表框app

RingtonePreference —— 鈴聲less

其實在Android源碼系統中還有不少的」未完工」的Preference, 沒有爲它們提供PI接口，例如SeekBarPreference，ide

有興趣的同窗能夠參考源碼，具體路徑爲：frameworks/base/core/java/preference。函數

組合控件：

PreferenceCategory :相似於LinearLayou、RelativeLayout，用於組合一組Preference，使佈局更具有層次感。oop

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中配置以下：

[java] view plain copy print ?

<Preference android:key="wifi_setting" android:title="Wi-Fi設置"
android:summary="設置和管理無線接入點" android:dependency="apply_wifi">
<intent android:action="com.feixun.action.seemAction"
android:targetPackage="com.feixun.qin" android:targetClass="com.feixun.qin.MainActivity" />
</Preference>

方法二：能夠在onPreferenceTreeClick()建立新的intent顯示的進行跳轉。

接下來，對每一個Preference的的獨有XML Attributes和方法進行一下總結，使你們有更好的深刻理解。

一、EditPreference

方法：

getEditText() 返回的是咱們在該控件中輸入的文本框值

getText() 返回的是咱們以前sharedPreferen文件保存的值

效果圖：

二、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進行分析。效果圖：

採用的數組爲：

[java] view plain copy print ?

<?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>

三、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的方法獨立與其餘兩種方法的運行。也就是說，它老是會運行。

補充：點擊某個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的佈局文件以下：

[java] view plain copy print ?

<?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 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，代碼以下：

[java] view plain copy print ?

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; //保存更新後的值
}
}