Android之Preference
2012-08-20 19:32 ...平..淡... 阅读(1317) 评论(0) 编辑 收藏 举报首先介绍下什么是 PerferenceActivity,看下面的截图:
Android系统截图 MusicPlayer Setting截图
Android系统本身大量用到了PreferenceActivity来对系统进行信息配置和管理。那么它是怎么保存数据的呢,如何创建PrefenceActivity的呢,更关键是怎样触发相应事件的呢?
第一个问题:PreferenceActivity是如何保存的数据。
Android系统有四种基本的数据保存方法:
1.SharedPreference
2.文件
3.SQLite
4.ContentProvider
Preference,其实是通过SharedPreferneces以键值对的形式进行保存的,当然,我们也可以通过SharedPreferences来获取PreferenceActivity设置的值。
第二个问题:如何创建一个PreferenceActivity。 其实Eclipse提供了相应的创建工具,和创建Layout是基本相同的。步骤如下:
创建Android项目,并添加一个Android xml文件。注意,这次选择的不是Layout,而是Preference,而且注意Folder路径是 res/xml
添加完成之后,在res/xml/下打开添加的preference.xml文件。可以看到Android也为我们提供两种编辑模式,可视化的结构设计及xml源码设计。推荐使用structure进行创建。如图所示:
下面我们看看PrefeneceActivity都提供了哪几种元素可供使用。点击Add按钮,在打开的新窗口中可以看到以下几项:
下面,我们对比Preference和View下的各个子控件,对他们的家庭元素在宏观上有更好的把握性。
单一控件: Preference 控件家庭 View控件家庭 控件含义 Preference TextView 文本框 CheckPreference CheckBox 单选框 EditTextPreference EditText 输入文本框 ListPreference ListView 列表框 RingtonePreference —— 铃声 其实在Android源码系统中还有很多的”未完工”的Preference, 没有为它们提供PI接口,例如SeekBarPreference, 有兴趣的同学可以参考源码,具体路径为:frameworks/base/core/java/preference。 组合控件: PreferenceCategory : 类似于LinearLayout、RelativeLayout,用于组合一组Preference,使布局更具备层次感。 PreferenceScreen : 所有Preference元素的根节点。
接下来,对每个Preference的独有XML Attributes和方法进行一下总结,使大家能更好地理解。
CheckBoxPreference:CheckBox选择项,对应的值的ture或flase。如图:
EditTextPreference:输入编辑框,值为String类型,会弹出对话框供输入。
ListPreference: 列表选择,弹出对话框供选择。
Preference:只进行文本显示,需要与其他进行组合使用。
PreferenceCategory:用于分组。效果如下:
PreferenceScreen:PreferenceActivity的根元素,必须为它。
RingtonePreference:系统玲声选择。
OK,Preference的基本控件和PreferenceActivity介绍完毕,下一节对Preference的各个控件的属性方法等做一个介绍。
---------------------------------------------------------------------------------------------------------------
首先了解Preference的属性及方法
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()
简易效果图
下面通过分析MusicPlayer Setting来了解各个Preference控件的使用。
第一部分为“我的位置”:包括“使用无线网线”和“使用GPS”两个部分,而且都是CheckBox,根据上节学习,应该包括一个PreferenceCategory和两个CheckBoxPreference。
Xml代码:
<PreferenceCategory android:title="我的位置" android:key="set_local"> <CheckBoxPreference android:key="apply_wifi" android:summary="使用无线网络在应用程序(例如Google地图)中查看位置" android:title="使用无线网络" android:defaultValue="true"> </CheckBoxPreference> <CheckBoxPreference android:key="apply_gps" android:summary="定位到街道级别(需要消耗更多的电量以及天气允许)" android:title="使用GPS"> </CheckBoxPreference> </PreferenceCategory>
PreferenceCategory属性分析:
android:title:显示的标题
android:key :唯一标识(至少在同一程序中是唯一),SharedPreferences也将通过此Key值进行数据保存,也可以通过key值获取保存的信息 (以下相同)。
CheckBoxPreference属性分析:
android:Key :唯一标识.
android:title :显示标题(大字体显示)
android:summary :副标题(小字体显示)
android:defaultValue:默认值(当然,此处只能是true或false了)
Preference.xml的第二部分为"无线和网络设置",此部分包括的内容比较多,也稍微复杂,一步一步来分析。xml代码如下:
<PreferenceCategory android:title="无线和网络设置">
<CheckBoxPreference
android:key="apply_fly"
android:summary="禁用所有无线连接"
android:title="飞行模式"> </CheckBoxPreference>
<CheckBoxPreference
android:key="apply_internet"
android:summary="禁用通过USB共享Internet连接" android:title="Internet共享"> </CheckBoxPreference>
<CheckBoxPreference
android:key="apply_wifi"
android:summary="打开Wi-Fi"
android:title="Wi-Fi"> </CheckBoxPreference>
<Preference
android:summary="设置和管理无线接入点"
android:title="Wi-Fi设置"
android:dependency="apply_wifi"
android:key="wifi_setting"> </Preference>
<CheckBoxPreference
android:key="apply_bluetooth"
android:summary="启用蓝牙"
android:title="蓝牙"> </CheckBoxPreference>
<Preference
android:summary="管理连接、设备设备名称和可检测性"
android:title="蓝牙设置"
android:dependency="apply_bluetooth"
android:key="bluetooth_setting"> </Preference>
<EditTextPreference
android:key="number_edit"
android:title="输入电话号码"> </EditTextPreference>
<ListPreference
android:title="部门设置"
android:entries="@array/department" android:entryValues="@array/department_value" android:dialogTitle="选择部门" android:key="depart_value"> </ListPreference>
<RingtonePreference
android:ringtoneType="all"
android:title="玲聲" android:showDefault="true"
android:key="ring_key" android:showSilent="true"> </RingtonePreference>
</PreferenceCategory>
第二部分中前三个都为CheckBoxPreference,不心多说,从<Preference android:key="bluetooth_setting"/>开始。
Preference 属性分析:
android :Key:唯一标识.
android:title :显示标题(大字体显示)
android:summary :副标题(小字体显示)
android:dependency:附属,即标识此元素附属于某一个元素(通常为CheckBoxPreference),dependency值为所附属元素的key。上面代码中的Preference元素附属于key等于"apply_bluetooth"的CheckPreference元素,当CheckPreference值为true时,Preference则为可用,否则为不可用。
EditTextPreperence 属性和方法分析:
属性:
android:Key :唯一标识. android:title:显示标题(大字体显示)
方法:
getEditText() 返回的是我们在该控件中输入的文本框值
getText() 返回的是我们之前sharedPreferen文件保存的值
ListPreference 属性和方法分析:
属性:
android:Key :唯一标识.
android:title :显示标题(大字体显示)
android:dialogTitle:弹出对话框的标题
android:entries :列表中显示的值。为一个数组,通读通过资源文件进行设置。
android:entryValues:列表中实际保存的值,也entries对应。为一个数组,通读通过资源文件进行设置。以下代码显示的是arrays.xml文件中内容:
<resources> <string-array name="department"> <item>综合部</item> <item>行政部</item> <item>外贸部</item> </string-array> <string-array name="department_value"> <item>001</item> <item>002</item> <item>003</item> </string-array> </resources>
方法:
CharSequence[] getEntries(): 返回的是控件显示文本的一个”key”数组,对应于属性android:entries
CharSequence[] getEntryValues():返回的一个”value”数组,对应于属性android: entryValues
CharSequence getEntry(): 返回当前选择文本
String getValue() :返回当前选中文本选中的value 。
RingtonePreference属性分析:
属性: android:ringtoneType:响铃的铃声类型,主要有:ringtone(音乐)、notification(通知)、alarm(闹铃)、all(所有可用声 音类型)。 android:showDefault :默认铃声,可以使用系统(布尔值---true,false)的或者自定义的铃声 android:showSilent :指定铃声是否为静音。指定铃声包括系统默认铃声或者自定义的铃声
OK,Preference.xml内容已经分析完毕,属性都大致相同。
--------------------------------------------------------------------------
那么如何把Preference.xml中内容展现出来呢?
PreferenceActivity是专门用于显示preference的,所以只要创建一个继承自PreferenceActivity类即可。代码如下,在onCreate方法中通过addPreferencesFromResource()实现:
1 public class Setting extends PreferenceActivity { 2 @Override 3 public void onCreate(Bundle savedInstanceState) { 4 super.onCreate(savedInstanceState); 5 // 所的的值将会自动保存到SharePreferences 6 addPreferencesFromResource(R.xml.preference); 7 } 8 }
接下来就是运行程序,显示劳动成果。至此,工作已经完成大半,所有的值都会保存到SharedPreferences中,我们也可以读取到保存的结果。
重点:分析Preference事件
那么,如何响应PreferenceActivity的操作。其实只要重写PreferenceActivity的 onPreferenceTreeClick方法就可以了,通过参数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()方法,
(1) 如果该方法返回true,则不再调用onPreferenceTreeClick方法 ;
(2) 如果onPreferenceClick方法返回false,则继续调用onPreferenceTreeClick方法。
2 onPreferenceChange的方法独立与其他两种方法的运行。也就是说,它总是会运行。
到此关于PreferenceActvity和Preference的分析基本结束。
--------------------------------------------------------------------
获取配置信息
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1 /** 2 * 获取是否播放声音 3 */ 4 public static boolean playSounds(Context context) { 5 return PreferenceManager.getDefaultSharedPreferences(context).getBoolean(SOUNDS, SOUNDS_DEFAULT); 6 } 7 8 /** 9 * 设置播放的声音 10 * @param context 上下文 11 * @param value 是否播放 12 */ 13 public static void setPlaySounds(Context context, boolean value) { 14 PreferenceManager.getDefaultSharedPreferences(context).edit().putBoolean(SOUNDS, value).commit(); 15 } 16 17 /** 18 * 获取警告时间 19 * @param context 上下文 20 * @return 警告时间秒 21 */ 22 public static int getWarningTime(Context context) { 23 String value=PreferenceManager.getDefaultSharedPreferences(context).getString(WARNING_TIME,Integer.toString(WARNING_TIME_DEFAULT)); 24 try 25 { 26 return Integer.parseInt(value); 27 } 28 catch(NumberFormatException e) 29 { 30 setWarningTime(context, WARNING_TIME_DEFAULT); 31 return WARNING_TIME_DEFAULT; 32 } 33 34 } 35 36 /** 37 * 设置警告时间 38 * @param context 上下文 39 * @param warningTime 警告时间 40 */ 41 public static void setWarningTime(Context context, int warningTime) { 42 PreferenceManager.getDefaultSharedPreferences(context).edit().putString(WARNING_TIME, Integer.toString(warningTime)).commit(); 43 44 } 45 46 /** 47 * 参加人数无限制 48 * @param context 49 * @return 50 */ 51 public static boolean allowUnlimitedParticipants(Context context) { 52 return PreferenceManager.getDefaultSharedPreferences(context).getBoolean(UNLIMITED_PARTICIPANTS, UNLIMITED_PARTICIPANTS_DEFAULT); 53 } 54 55 public static void setAllowUnlimitedParticipants(Context context, boolean value) { 56 PreferenceManager.getDefaultSharedPreferences(context).edit().putBoolean(UNLIMITED_PARTICIPANTS, value).commit(); 57 } 58 59 /** 60 * 允许编辑会议时间 61 * @param context 62 * @return 63 */ 64 public static boolean allowVariableMeetingLength(Context context) { 65 return PreferenceManager.getDefaultSharedPreferences(context).getBoolean(VARIABLE_MEETING_LENGTH, VARIABLE_MEETING_LENGTH_DEFAULT); 66 } 67 68 public static void setAllowVariableMeetingLength(Context context, boolean value) { 69 PreferenceManager.getDefaultSharedPreferences(context).edit().putBoolean(VARIABLE_MEETING_LENGTH, value).commit(); 70 }
Preferencescreen的应用:它不仅可以作为设置界面显示,而且还能够启动activity,下面主要是对启动activity的介绍
1. Preferencescreen中启动activity
例如wireless_setting.xml中有如下片段
<PreferenceScreen
xmlns:android="http://schemas.android.com/apk/res/android" xmlns:settings="http://schemas.android.com/apk/res/com.seedshope.android"> <PreferenceScreen android:key="wifi_settings" android:title="@string/wifi_settings" android:summary="@string/wifi_settings_summary" > <intent android:action="android.intent.action.MAIN" android:targetPackage="com.android.settings" android:targetClass="com.android.settings.wifi.WifiSettings" /> </PreferenceScreen> </PreferenceScreen>
其中com.android.settings是工程的包名,com.android.settings.wifi.WifiSettings是要启动的类。
一般情况下这样就ok了,点击对应的Preference就能启动对应的activity,然而仅仅这样,并不一定能够启动对应的activity,因为它与回调函数onPreferenceTreeClick有关,有时候我们会重写这个方法如:
1 public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen, Preference preference) { 2 if ( (preference == mAirplaneModePreference) && (Boolean.parseBoolean(SystemProperties.get(TelephonyProperties.PROPERTY_INECM_MODE))) ) { 4 // In ECM mode launch ECM app dialog 5 startActivityForResult( new Intent(TelephonyIntents.ACTION_SHOW_NOTICE_ECM_BLOCK_OTHERS, null), REQUEST_CODE_EXIT_ECM); 8 return true; 9 } 10 else { 11 // Let the intents be launched by the Preference manager 12 return false; 13 } 14 }
其中WirelessSetting.java中有如上函数,当返回值为true时,你怎么点击Preference都不会跳转到activity的,只有等到它的返回值为false的时候,才可以正常跳转,因为点击某一个Preference的真正实现在Preference.java的performClick函数中如下:
1 void performClick(PreferenceScreen preferenceScreen) { 2 if (!isEnabled()) { 3 return; 4 } 5 onClick(); 6 if (mOnClickListener != null && mOnClickListener.onPreferenceClick(this)) { 7 return; 8 } 9 PreferenceManager preferenceManager = getPreferenceManager(); 10 if (preferenceManager != null) { 11 PreferenceManager.OnPreferenceTreeClickListener listener = preferenceManager.getOnPreferenceTreeClickListener(); 12 if (preferenceScreen != null && listener != null && listener.onPreferenceTreeClick(preferenceScreen, this)) { 13 return; 14 } 15 } 16 if (mIntent != null) { 17 Context context = getContext(); 18 context.startActivity(mIntent); 19 } 20 }
当点击某个Preference时的调用流程是
AdapterView.performItemClick--->PreferenceScreen.onItemClick--->Preference.performClick--->PreferenceActivity.onPreferenceTreeClick
当onPreferenceTreeClick返回true的时候就直接return了,没有走下面启动activity的地方了,因此要使一个Preference能够正常跳转到另外一个activity有两个条件,
1.xml里面是否设置正确
2.调用该xml的java类是否在onPreferenceTreeClick这个函数需要返回false
转自:
http://blog.csdn.net/qinjuning/article/details/6710003
http://www.cnblogs.com/joey-home/archive/2012/02/03/2336778.html