0介绍
Android系统内的设置界面由Android Preference相关类提供,使用preference这个键值对的方式来自动保存这些数据,并即时生效,同时Android提供一种类似layout的方式来进行Preference的布局。其中,使用PreferenceScreen和PreferenceCategory对布局进行控制,设置子项包含以下种类: LListPreference,CheckBoxPreference,EditTextPreference,RingtonePreference,EditPhoneNumberPreference等。设置数据的保存和读取通过全局保存对象SharedPreferences
实现,保存时触发相应事件通过Preference.onPreferenceChangeListener
实现。下面分别介绍各类。
1 配置文件示例
配置功能xml示例
2 设置页面布局
<?xml version="1.0" encoding="utf-8"?><PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"> <CheckBoxPreference android:key="music" android:title="@string/music_title" android:summary="@string/music_summary" android:defaultValue="true" /> <CheckBoxPreference android:key="hints" android:title="@string/hints_title" android:summary="@string/hints_summary" android:defaultValue="true" /> <PreferenceScreen android:key="detailSetting" android:title="@string/detail_setting_title" android:summary="@string/detail_setting_summary"> <CheckBoxPreference android:key="music1" android:title="@string/music_title" android:summary="@string/music_summary" android:defaultValue="true" /> <CheckBoxPreference android:key="music2" android:title="@string/music_title" android:summary="@string/music_summary" android:defaultValue="true" /> </PreferenceScreen> <PreferenceScreen android:key="customSetting" android:title="@string/custom_setting_title" android:summary="@string/custom_setting_summary"> <intent android:action="android.intent.action.MAIN" android:targetPackage="com.rasa.game" android:targetClass="com.rasa.game.CustomSetting" /> </PreferenceScreen> <com.rasa.game.CustomPreference android:key="my_preference" android:title="Advance Preference" android:summary="You can custom design your prefrence UI" android:defaultValue="100" /> </PreferenceScreen>
2.1 PreferenceScreen
每一个设置界面就是一个PreferenceScreen,因此其xml配置文件到根节点是 PreferenceScreen,其内可包含 PreferenceScreen, PreferenceCategory,其他设置项如 ListPreference, CheckBoxPreference等。 此项包含的所有子项在新屏幕上显示,就好像进入二级菜单。
处于内层的PreferenceScreen被点击时,在新页面中显示其内的两个CheckBoxPreference选项。
view code
<PreferenceScreen android:key="detailSetting" android:title="@string/detail_setting_title" android:summary="@string/detail_setting_summary"> <CheckBoxPreference android:key="music1" android:title="@string/music_title" android:summary="@string/music_summary" android:defaultValue="true" /> <CheckBoxPreference android:key="music2" android:title="@string/music_title" android:summary="@string/music_summary" android:defaultValue="true" /></PreferenceScreen>
也可以设置内层PreferenceScreen的Intent属性,设置点击PreferenceScreen时跳转到com.android.phone.SelectSimCard页面。如:
View Code
<PreferenceScreen android:key="config_sub" android:title="@string/sel_sub_title" android:summary="@string/sel_sub_summary" android:persistent="false"> <intent android:action="android.intent.action.MAIN" android:targetPackage="com.android.phone" android:targetClass="com.android.phone.SelectSimCard" /></PreferenceScreen>
2.2 PreferenceCategory
PreferenceCategory 为设置选项类别,其内部包含一个或多个设置选项。如 PreferenceScreen, 其他设置项如 ListPreference, CheckBoxPreference等。
PreferenceCategory在设置界面上显示为一个类别标题。 PreferenceCategory是一个逻辑上的类别概念。
3 常用设置项
ListPreference 带下拉的设置项
CheckBoxPreference 带CheckBox的设置项
EditTextPreference 输入文本到设置项
RingtonePreference 铃声设置项
EditPhoneNumberPreference 号码设置项
…...
3.1 设置项属性
Key为这个Preference的ID,设置了才可以在代码中引用
Title是显示的标题
Summary是显示在标题下的文字介绍
Dependency:可用来配置此设置项是否依赖于其他配置项,如:填写一个CheckBoxPreference的Key,这样就会在填写的那个CheckBoxPreference勾选时当前这个Preference才可用
Default Value为初始值
4 自定义设置项
默认提供的设置项不能满足全部要求,因此,会根据需要对设置项进行自定义。
1)首先扩展Preference类,注意使用SharedPreferences对配置项进行保存。
2)定义此Preference类对应的layout
3)直接用标签引用此Preference。如:
View Code
<com.rasa.game.CustomPreference android:key="my_preference" android:title="Advance Preference" android:summary="You can custom design your prefrence UI" android:defaultValue="100" />
5 设置变化事件
6 设置的读取和保存
1.全局保存对象SharedPreferences
在android中,最简单的持久化数据的办法是使用Preferences API,获取preference对象有三种方式,都是通过Activity对象的方法,获取的是android.content.SharedPreferences对象实例。
getPreferences():获取到作用域是本Activity的preference
getSharedPreferences():获取到作用域是本应用程序的preference
getDefaultSharedPreferences():获取到全局作用域的preference
保存方式如下:
View Code
String STORE_NAME = "Settings"; SharedPreferences settings = getSharedPreferences(STORE_NAME, MODE_PRIVATE); SharedPreferences.Editor editor = settings.edit(); editor.putInt("sourceType", 0); editor.commit(); SharedPreferences实例是通过:
get方法获取对应键的值;
edit方法获取SharedPreferences.Editor对象
通过SharedPreferences.Editor的put方法写入键值对
保存需要commit方法
2.是否保存
Preference.setOnPreferenceChangeListener
通过在子类中调用此方法来设置监听,在变化后进行保存。
ListPreference继承于DialogPreference,对onDialogClosed函数进行了覆盖,代码如下:
View Code
@Override protected void onDialogClosed(boolean positiveResult) { super.onDialogClosed(positiveResult); if (positiveResult) {// 是否是ok按钮点击?----------------------------------------(A) String value = mEditText.getText().toString();// 获取EditText控件的内容 if (callChangeListener(value)) {// 应用层是否关注此值变化---------------------(C) setText(value);// 设置新的值--------------------------------------------------(D) } } }
从以上可以看到,如果应用层允许保存用户设置的新值,则进行保存
其中(D)最终调用Preference类的setPersistentString()函数进行保存。
此函数可以从Preference.java的源码callChangeListener看到,看应用程序是否设置了
setOnPreferenceChangeListener,这个一般是继承的PerferenceActivity的类来调用一个listener或者自身,
如果没有没有设置 ,用户即忽略参数变化。
转载博客园:
http://archive.cnblogs.com/a/2172773/