Android中Preference的使用以及监听事件分析

时间:2024-04-02 07:13:56

在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属性的值。

一个简易的效果图如下:

Android中Preference的使用以及监听事件分析

Preference的跳转:

方法一:在配置每个Preference元素节点时,我们可以显示为点击它时所跳转的Intent。点击该Preference,跳转至目标Intent。除非在onPreferenceTreeClick()方法中进行抉择。在xml中配置如下:

  1. <Preferenceandroid:key="wifi_setting"android:title="Wi-Fi设置"
  2. android:summary="设置和管理无线接入点"android:dependency="apply_wifi">
  3. <!--点击时自定义一个默认跳转Intentaction指定隐式Intent-->
  4. <!--action指定隐式Intent;targetPackage和targetClass指定显示Intent-->
  5. <intentandroid:action="com.feixun.action.seemAction"
  6. android:targetPackage="com.feixun.qin"android:targetClass="com.feixun.qin.MainActivity"/>
  7. </Preference>

方法二:可以在onPreferenceTreeClick()创建新的intent显示的进行跳转。

接下来,对每个Preference的的独有XML Attributes和方法进行一下总结,使大家有更好的深入理解。

1、EditPreference

方法:

getEditText() 返回的是我们在该控件中输入的文本框值

getText() 返回的是我们之前sharedPreferen文件保存的值

效果图:

Android中Preference的使用以及监听事件分析

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

CharSequencegetEntry(): 返回当前选择文本

String getValue() :返回当前选中文本选中的value 。

与之对应的还有它们所对应的setXXX()方法,可以参考SDK进行分析。效果图:

Android中Preference的使用以及监听事件分析

采用的数组为:

  1. <?xmlversion="1.0"encoding="utf-8"?>
  2. <resources>
  3. <string-arrayname="department">
  4. <item>IT</item>
  5. <item>Commerce</item>
  6. <item>HR</item>
  7. </string-array>
  8. <string-arrayname="department_value">
  9. <item>001</item>
  10. <item>002</item>
  11. <item>003</item>
  12. </string-array>
  13. </resources>

3、RingtonePreference

XML Attributes:

android:ringtoneType:响铃的铃声类型,主要有:ringtone(音乐)、notification(通知)、alarm(闹铃)

、all(所有可用声 音类型)。

android:showDefault:默认铃声,可以使用系统(布尔值---true,false)的或者自定义的铃声

android:showSilent :指定铃声是否为静音。指定铃声包括系统默认铃声或者自定义的铃声

效果图:

Android中Preference的使用以及监听事件分析

重点:分析Preference事件

在PreferenceActivity方法中,一个比较重要的监听点击事件方法为:

public booleanonPreferenceTreeClick (PreferenceScreen preferenceScreen, Preference preference)

说 明 :当Preference控件被点击时,触发该方法。

参数说明: preference 点击的对象。

返回值: true 代表点击事件已成功捕捉,无须执行默认动作或者返回上层调用链。 例如,不跳转至默认Intent。

false 代表执行默认动作并且返回上层调用链。例如,跳转至默认Intent。

在我们继承PreferenceActivity的Activity可以重写该方法,来完成我们对Preference事件的捕捉。

相信通过前面的介绍,你一定知道了如何使用了Preference家族并且对其触发方法。下面我们抛出另外两枚——

Preference相关的两个重要监听接口。

Preference.OnPreferenceChangeListener 该监听器的一个重要方法如下:

boolean onPreferenceChange(Preferencepreference,ObjectobjValue)

说明: 当Preference的元素值发送改变时,触发该事件。

返回值:true 代表将新值写入sharedPreference文件中。

false 则不将新值写入sharedPreference文件

Preference.OnPreferenceClickListener 该监听器的一个重要方法如下:

public booleanonPreferenceClick(Preference preference)

说明:当点击控件时触发发生,可以做相应操作。

那么当一个Preference控件实现这两个接口时,当被点击或者值发生改变时,触发方法是如何执行的呢?事实上,

它的触发规则如下:

1先调用onPreferenceClick()方法,如果该方法返回true,则不再调用onPreferenceTreeClick方法 ;

如果onPreferenceClick方法返回false,则继续调用onPreferenceTreeClick方法。

2onPreferenceChange的方法独立与其他两种方法的运行。也就是说,它总是会运行。

那么,开始我们的实战之旅吧! 下面给您最火热的战场。

1,新建我们的preference.xml文件。

① 在res文件夹下,新建xml文件夹。

② 在新建的xml文件夹下,新建Android XML File。命名为mypeference.xml 。类型选择为Preference。

③打开我们的mypeference.xml,视图选择Structure。可以手动配置我们的布局文件。可选的Preference空间如下:

Android中Preference的使用以及监听事件分析

Demo中mypeference.xml的布局文件如下:

  1. <?xmlversion="1.0"encoding="utf-8"?>
  2. <PreferenceScreenxmlns:android="http://schemas.android.com/apk/res/android">
  3. <PreferenceCategoryandroid:title="我的位置"
  4. android:key="set_local"/>
  5. <CheckBoxPreferenceandroid:key="apply_wireless"
  6. android:title="使用无线网络"android:summary="使用无线网络在应用程序(例如Google地图)中查看位置"
  7. android:defaultValue="true">
  8. </CheckBoxPreference>
  9. <CheckBoxPreferenceandroid:key="apply_gps"
  10. android:title="使用GPS"android:summary="定位到街道级别(需要消耗更多的电量以及天气允许)">
  11. </CheckBoxPreference>
  12. <PreferenceCategoryandroid:title="无线和网络设置"></PreferenceCategory>
  13. <CheckBoxPreferenceandroid:key="apply_fly"
  14. android:title="飞行模式"android:summary="禁用所有无线连接">
  15. </CheckBoxPreference>
  16. <CheckBoxPreferenceandroid:key="apply_internet"
  17. android:title="Internet共享"android:summary="禁用通过USB共享Internet连接">
  18. </CheckBoxPreference>
  19. <CheckBoxPreferenceandroid:key="apply_wifi"
  20. android:title="Wi-Fi"android:summary="打开Wi-Fi">
  21. </CheckBoxPreference>
  22. <Preferenceandroid:key="wifi_setting"android:title="Wi-Fi设置"
  23. android:summary="设置和管理无线接入点"android:dependency="apply_wifi">
  24. <!--点击时自定义一个默认跳转Intentaction指定隐式Intent-->
  25. <!--action指定隐式Intent;targetPackage和targetClass指定显示Intent-->
  26. <intentandroid:action="com.feixun.action.seemAction"
  27. android:targetPackage="com.feixun.qin"android:targetClass="com.feixun.qin.MainActivity"/>
  28. </Preference>
  29. <CheckBoxPreferenceandroid:key="apply_bluetooth"
  30. android:title="蓝牙"android:summary="启用蓝牙">
  31. </CheckBoxPreference>
  32. <Preferenceandroid:key="bluetooth_setting"android:title="蓝牙设置"
  33. android:summary="管理连接、设备设备名称和可检测性"android:dependency="apply_bluetooth">
  34. </Preference>
  35. <EditTextPreferenceandroid:key="number_edit"
  36. android:title="输入电话号码"android:defaultValue="123">
  37. </EditTextPreference>
  38. <ListPreferenceandroid:key="depart_value"
  39. android:title="部门设置"android:dialogTitle="选择部门"android:entries="@array/department"
  40. android:entryValues="@array/department_value">
  41. </ListPreference>
  42. <RingtonePreferenceandroid:key="ring_key"
  43. android:title="铃声"android:ringtoneType="all"android:showDefault="true"
  44. android:showSilent="true">
  45. </RingtonePreference>
  46. </PreferenceScreen>

2,新建一个HelloActivity继承PreferenceActivity,代码如下:

  1. packagecom.feixun.qin;
  2. importandroid.content.Intent;
  3. importandroid.content.SharedPreferences;
  4. importandroid.os.Bundle;
  5. importandroid.preference.CheckBoxPreference;
  6. importandroid.preference.EditTextPreference;
  7. importandroid.preference.ListPreference;
  8. importandroid.preference.Preference;
  9. importandroid.preference.PreferenceActivity;
  10. importandroid.preference.PreferenceManager;
  11. importandroid.preference.PreferenceScreen;
  12. importandroid.preference.Preference.OnPreferenceClickListener;
  13. importandroid.util.Log;
  14. publicclassHelloPreferenceextendsPreferenceActivityimplements
  15. Preference.OnPreferenceClickListener,
  16. Preference.OnPreferenceChangeListener{
  17. privatestaticStringTAG="HelloPreference";
  18. privateCheckBoxPreferencemapply_wifiPreference;//打开wifi
  19. privateCheckBoxPreferencemapply_internetPreference;//Internet共享
  20. privateListPreferencedepart_valuePreference;//部门设置
  21. privateEditTextPreferencenumber_editPreference;//输入电话号码
  22. privatePreferencemwifi_settingPreference;//wifi设置
  23. privateStringoldDeptId;//旧部门的名称
  24. publicvoidonCreate(BundlesavedInstanceState){
  25. super.onCreate(savedInstanceState);
  26. addPreferencesFromResource(R.xml.mypreference);
  27. //根据key值找到控件
  28. mapply_wifiPreference=(CheckBoxPreference)findPreference("apply_wifi");
  29. mapply_internetPreference=(CheckBoxPreference)findPreference("apply_internet");
  30. depart_valuePreference=(ListPreference)findPreference("depart_value");
  31. number_editPreference=(EditTextPreference)findPreference("number_edit");
  32. mwifi_settingPreference=(Preference)findPreference("wifi_setting");
  33. //设置监听器
  34. mapply_internetPreference.setOnPreferenceClickListener(this);
  35. mapply_internetPreference.setOnPreferenceChangeListener(this);
  36. depart_valuePreference.setOnPreferenceClickListener(this);
  37. depart_valuePreference.setOnPreferenceChangeListener(this);
  38. number_editPreference.setOnPreferenceClickListener(this);
  39. number_editPreference.setOnPreferenceChangeListener(this);
  40. mwifi_settingPreference.setOnPreferenceClickListener(this);
  41. //得到我们的存储Preferences值的对象,然后对其进行相应操作
  42. SharedPreferencesshp=PreferenceManager.getDefaultSharedPreferences(this);
  43. booleanapply_wifiChecked=shp.getBoolean("apply_wifi",false);
  44. }
  45. //对控件进行的一些操作
  46. privatevoidoperatePreference(Preferencepreference){
  47. if(preference==mapply_wifiPreference){//点击了"打开wifi"
  48. Log.i(TAG,"WifiCB,andisCheckd="+mapply_wifiPreference.isChecked());
  49. }elseif(preference.getKey().equals("apply_internet")){//点击了"Internet共享"
  50. Log.i(TAG,"internetCB,andisCheckd="+mapply_internetPreference.isChecked());
  51. }elseif(preference==depart_valuePreference){//点击了"部门设置"
  52. Log.i(TAG,"departmentCB,andselectValue="+depart_valuePreference.getValue()+",Text="+depart_valuePreference.getEntry());
  53. }elseif(preference.getKey().equals("wifi_setting")){//点击了"wifi设置"
  54. mwifi_settingPreference.setTitle("itsturnme.");
  55. }elseif(preference==number_editPreference)//点击了"输入电话号码"
  56. Log.i(TAG,"OldValue="+number_editPreference.getText()+",NewValue="+number_editPreference.getEditText().toString());
  57. }
  58. //点击事件触发
  59. @Override
  60. publicbooleanonPreferenceClick(Preferencepreference){
  61. //TODOAuto-generatedmethodstub
  62. Log.i(TAG,"onPreferenceClick----->"+String.valueOf(preference.getKey()));
  63. //对控件进行操作
  64. operatePreference(preference);
  65. returnfalse;
  66. }
  67. //点击事件触发
  68. publicbooleanonPreferenceTreeClick(PreferenceScreenpreferenceScreen,
  69. Preferencepreference){
  70. Log.i(TAG,"onPreferenceTreeClick----->"+preference.getKey());
  71. //对控件进行操作
  72. operatePreference(preference);
  73. if(preference.getKey().equals("wifi_setting")){
  74. //创建一个新的Intent,
  75. //函数如果返回true,则跳转至该自定义的新的Intent;
  76. //函数如果返回false,则跳转至xml文件中配置的Intent;
  77. Intenti=newIntent(HelloPreference.this,OtherActivity.class);//OtherActivity只是一个简单的Activity
  78. i.putExtra("type","wifi");
  79. startActivity(i);
  80. returntrue;
  81. }
  82. returnfalse;
  83. }
  84. //当Preference的值发生改变时触发该事件,true则以新值更新控件的状态,false则donoting
  85. publicbooleanonPreferenceChange(Preferencepreference,ObjectobjValue){
  86. Log.i(TAG,"onPreferenceChange----->"+String.valueOf(preference.getKey()));
  87. if(preference==mapply_wifiPreference){
  88. Log.i(TAG,"WifiCB,andisCheckd="+String.valueOf(objValue));
  89. }elseif(preference.getKey().equals("apply_internet")){
  90. Log.i(TAG,"internetCB,andisCheckd="+String.valueOf(objValue));
  91. returnfalse;//不保存该新值
  92. }elseif(preference==depart_valuePreference){
  93. Log.i(TAG,"OldValue"+depart_valuePreference.getValue()+"NewDeptName"+objValue);
  94. }elseif(preference.getKey().equals("wifi_setting")){
  95. Log.i(TAG,"change"+String.valueOf(objValue));
  96. mwifi_settingPreference.setTitle("itsturnme.");//重新设置title
  97. }elseif(preference==number_editPreference){
  98. Log.i(TAG,"OldValue="+String.valueOf(objValue));
  99. returnfalse;//不保存更新值
  100. }
  101. returntrue;//保存更新后的值
  102. }
  103. }


3,AndroidManifest 文件如下:

  1. <?xmlversion='1.0'encoding='utf-8'standalone='yes'?>
  2. <map>
  3. <booleanname="apply_wifi"value="true"/>
  4. <booleanname="apply_internet"value="true"/>
  5. <stringname="number_edit">45677</string>
  6. <stringname="ring_key">content://settings/system/ringtone</string>
  7. <booleanname="apply_bluetooth"value="true"/>
  8. <booleanname="apply_fly"value="true"/>
  9. <stringname="depart_value">001</string>
  10. <booleanname="apply_gps"value="true"/>
  11. <booleanname="apply_wireless"value="false"/>
  12. </map>


程序运行后,效果如上所示,是不是很给力呀!

sharedPreference文件

前面我们说过,Android系统会将Preference元素的值存储在sharedPreference文件中。该文件存放路径位于

DDMS视图下的data/data/[packgename]/shared_prefs/文件下,命名约定为:packagename_preferencse.xml。

我们的com.feixun.qin_preferences.xm保存的值为:

  1. <?xmlversion='1.0'encoding='utf-8'standalone='yes'?>
  2. <map>
  3. <booleanname="apply_wifi"value="true"/>
  4. <booleanname="apply_internet"value="true"/>
  5. <stringname="number_edit">45677</string>
  6. <stringname="ring_key">content://settings/system/ringtone</string>
  7. <booleanname="apply_bluetooth"value="true"/>
  8. <booleanname="apply_fly"value="true"/>
  9. <stringname="depart_value">001</string>
  10. <booleanname="apply_gps"value="true"/>
  11. <booleanname="apply_wireless"value="false"/>
  12. </map>

已一个键值对的形式保存,name为Preference的key值,value为Preference的value值。

在应用程序中,我们可以通过代码的方式来访问该sharedPreference文件,继而可以对其进行读取甚至任何操作。

代码如下:

  1. //得到我们的存储Preferences值的对象,然后对其进行相应操作
  2. SharedPreferencesshp=PreferenceManager.getDefaultSharedPreferences(this);
  3. booleanapply_wifiChecked=shp.getBoolean("apply_wifi",false);

代码下载地址:http://download.csdn.net/detail/qinjuning/3807077

转自:http://blog.csdn.net/qinjuning