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


                                                                                                   

                                                                                                    轉載請注明出處: http://blog.csdn.net/qinjuning 

                  在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: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.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: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進行分析。效果圖:

                                 

         採用的數組為:      

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

 

 

       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的方法獨立與其它兩種方法的執行。也就是說,它總是會執行。


      補充:點擊某個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);


   

  

    就介紹到這兒了 。

 

       代碼下載地址:http://download.csdn.net/detail/qinjuning/3807077

 

 

 

 

 

 

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM