Android平台PreferenceActivity组件分析
1.PreferenceActivity 介绍
PreferenceActivity 继承ListActivity
它是以一个列表的形式在展现内容,它最主要的特点是添加Preference可以让控件的状态持久化储存,举个例子 比如用户选中checkbox后
退出应用然后在进入应用,这时用户希望看到的是checkbox被选中,所以软件须要记录用户每次操作的过程并且持久储存,在进入应用的时候须要判断这些久储存的数据然后将系统控件的状态呈现在UI中。
尤其是软件开发肯定会有一堆设置选项选项,每次进入Activity都去手动的去取储存的数据,这样代码会变得很复杂很麻烦。
这个时候Preference就出来了,它就是专门解决这些特殊的选项保存与读取的显示。用户每次操作事件它会及时的以键值对的形式记录在SharedPreferences中,Activity每次启动它会自动帮我们完成数据的读取以及UI的显示。
android开发中一共为我们提供了4个组件,分别是CheckBoxPreference组件、EditTextPreference组件、ListPreference组件、RingtonePreference组件,下面我用一个例子一一向同学们介绍一下。
2.CheckBoxPreference组件
CheckBoxPreference
选中为true 取消选中为false 它的值会以boolean的形式储存在SharedPreferences中。
1 <?xml version="1.0" encoding="utf-8"?> 2 <PreferenceScreen 3 xmlns:android="http://schemas.android.com/apk/res/android"> 4 <PreferenceCategory android:title="CheckBoxPreference"> 5 <CheckBoxPreference android:key="checkbox_0" 6 android:title="CheckBox_A" 7 android:summary="这是一个勾选框A" > 8 </CheckBoxPreference> 9 10 <CheckBoxPreference android:key="checkbox_1" 11 android:title="CheckBox_B" 12 android:summary="这是一个勾选框B" > 13 </CheckBoxPreference> 14 </PreferenceCategory> 15 </PreferenceScreen>
1 import android.content.Context; 2 import android.os.Bundle; 3 import android.preference.CheckBoxPreference; 4 import android.preference.Preference; 5 import android.preference.PreferenceActivity; 6 import android.preference.Preference.OnPreferenceChangeListener; 7 import android.preference.Preference.OnPreferenceClickListener; 8 import android.widget.Toast; 9 10 public class CheckBoxActivity extends PreferenceActivity { 11 12 Context mContext = null; 13 @Override 14 protected void onCreate(Bundle savedInstanceState) { 15 super.onCreate(savedInstanceState); 16 // 从资源文件中添Preferences ,选择的值将会自动保存到SharePreferences 17 addPreferencesFromResource(R.xml.checkbox); 18 19 mContext = this; 20 21 //CheckBoxPreference组件 22 CheckBoxPreference mCheckbox0 = (CheckBoxPreference) findPreference("checkbox_0"); 23 mCheckbox0.setOnPreferenceClickListener(new OnPreferenceClickListener() { 24 25 @Override 26 public boolean onPreferenceClick(Preference preference) { 27 //这里可以监听到这个CheckBox 的点击事件 28 return true; 29 } 30 }); 31 32 mCheckbox0.setOnPreferenceChangeListener(new OnPreferenceChangeListener() { 33 34 @Override 35 public boolean onPreferenceChange(Preference arg0, Object newValue) { 36 //这里可以监听到checkBox中值是否改变了 37 //并且可以拿到新改变的值 38 Toast.makeText(mContext, "checkBox_0改变的值为" + (Boolean)newValue, Toast.LENGTH_LONG).show(); 39 return true; 40 } 41 }); 42 43 CheckBoxPreference mCheckbox1 = (CheckBoxPreference) findPreference("checkbox_1"); 44 mCheckbox1.setOnPreferenceClickListener(new OnPreferenceClickListener() { 45 46 @Override 47 public boolean onPreferenceClick(Preference preference) { 48 //这里可以监听到这个CheckBox 的点击事件 49 return true; 50 } 51 }); 52 53 mCheckbox1.setOnPreferenceChangeListener(new OnPreferenceChangeListener() { 54 55 @Override 56 public boolean onPreferenceChange(Preference arg0, Object newValue) { 57 //这里可以监听到checkBox中值是否改变了 58 //并且可以拿到新改变的值 59 Toast.makeText(mContext, "checkBox_1改变的值为" + (Boolean)newValue, Toast.LENGTH_LONG).show(); 60 return true; 61 } 62 }); 63 64 } 65 66 }
1 <?xml version="1.0" encoding="utf-8"?> 2 <PreferenceScreen 3 xmlns:android="http://schemas.android.com/apk/res/android"> 4 <PreferenceCategory android:title="EditTextPreference"> 5 <EditTextPreference android:key="edit_0" 6 android:title="输入信息_A" 7 android:summary="请输入您的信息" 8 android:defaultValue="请输入信息" 9 android:dialogTitle="输入框"> 10 </EditTextPreference> 11 12 <EditTextPreference android:key="edit_1" 13 android:title="输入信息_B" 14 android:summary="请输入您的信息" 15 android:defaultValue="请输入信息" 16 android:dialogTitle="输入框"> 17 </EditTextPreference> 18 </PreferenceCategory> 19 </PreferenceScreen>
1 import android.content.Context; 2 import android.os.Bundle; 3 import android.preference.EditTextPreference; 4 import android.preference.PreferenceActivity; 5 6 public class EditTextActivity extends PreferenceActivity { 7 8 Context mContext = null; 9 10 @Override 11 protected void onCreate(Bundle savedInstanceState) { 12 super.onCreate(savedInstanceState); 13 // 从资源文件中添Preferences ,选择的值将会自动保存到SharePreferences 14 addPreferencesFromResource(R.xml.edittext); 15 16 mContext = this; 17 18 // EditTextPreference组件 19 EditTextPreference mEditText = (EditTextPreference) findPreference("edit_0"); 20 21 //设置dialog按钮信息 22 mEditText.setPositiveButtonText("确定"); 23 mEditText.setNegativeButtonText("取消"); 24 25 //设置按钮图标 26 mEditText.setDialogIcon(R.drawable.jay); 27 } 28 29 30 }
4.ListPreference组件
在res/array中先写两个数组,一个用与list的显示内容,一个用户list的选中数值。
1 <?xml version="1.0" encoding="utf-8"?> 2 <resources> 3 4 <string-array name="auto_logout_time_key"> 5 <item>10 mins.</item> 6 <item>20 mins.</item> 7 <item>30 mins.</item> 8 <item>60 mins.</item> 9 </string-array> 10 11 <string-array name="auto_logout_time_value"> 12 <item>600000</item> 13 <item>1200000</item> 14 <item>1800000</item> 15 <item>3600000</item> 16 </string-array> 17 </resources>
ListPreference点击后会弹出一个列表框,选中后会将选中的内容(上面数组中的值)会以字符串的的形式储存在SharedPreferences中。
1 <?xml version="1.0" encoding="utf-8"?> 2 <PreferenceScreen 3 xmlns:android="http://schemas.android.com/apk/res/android"> 4 <PreferenceCategory android:title="ListPreference"> 5 <ListPreference 6 android:key="list_0" 7 android:title="登录设置A" 8 android:dialogTitle="选择在线时间" 9 android:entries="@array/auto_logout_time_key" 10 android:entryValues="@array/auto_logout_time_value" > 11 </ListPreference> 12 13 <ListPreference 14 android:key="list_0" 15 android:title="登录设置A" 16 android:dialogTitle="选择在线时间" 17 android:entries="@array/auto_logout_time_key" 18 android:entryValues="@array/auto_logout_time_value" > 19 </ListPreference> 20 </PreferenceCategory> 21 </PreferenceScreen>
1 import android.os.Bundle; 2 import android.preference.PreferenceActivity; 3 4 public class ListActivity extends PreferenceActivity { 5 @Override 6 protected void onCreate(Bundle savedInstanceState) { 7 super.onCreate(savedInstanceState); 8 // 从资源文件中添Preferences ,选择的值将会自动保存到SharePreferences 9 addPreferencesFromResource(R.xml.list); 10 } 11 }
5.RingtonePreference组件
RingtonePreference点击后会弹出一个系统铃声的列表框,选中后会将选中的内容(uri字符集)会以字符串的的形式储存在SharedPreferences中。
1 <?xml version="1.0" encoding="utf-8"?> 2 <PreferenceScreen 3 xmlns:android="http://schemas.android.com/apk/res/android"> 4 <PreferenceCategory android:title="RingtonePreference"> 5 <RingtonePreference 6 android:key="ringtone_0" 7 android:summary="选择系统铃声A" 8 android:title="铃声设置" 9 android:ringtoneType="all" 10 android:showSilent="true" ></RingtonePreference> 11 12 <RingtonePreference 13 android:key="ringtone_!" 14 android:summary="选择系统铃声B" 15 android:title="铃声设置" 16 android:ringtoneType="all" 17 android:showSilent="true" ></RingtonePreference> 18 19 </PreferenceCategory> 20 </PreferenceScreen>
android:ringtoneType 系统一共提供了4中响铃模式的类型分别为 铃声(ringtone) 通知( notification) 警告(alarm) 全部(all) 模拟器默认是没有铃声的,下图中的铃声我是将歌曲文件拷贝到SD卡中,设置铃声后才会出现的。如果觉得拷贝麻烦可以使用豌豆荚或者91助手将歌曲文件放入手机SD卡中,在铃声设置那里设置一下在这里就会出现。
1 import android.os.Bundle; 2 import android.preference.PreferenceActivity; 3 4 public class RingtoneActivity extends PreferenceActivity { 5 @Override 6 protected void onCreate(Bundle savedInstanceState) { 7 super.onCreate(savedInstanceState); 8 // 从资源文件中添Preferences ,选择的值将会自动保存到SharePreferences 9 addPreferencesFromResource(R.xml.ringtone); 10 } 11 }
6.自定义Preferences
使用系统的控件在显示方面难免会有些单一,如果想做一个好看的界面就需要使用自定义Preference。下面我简单说明一下如何编写自定义Preference。首先在res/layout中添加preferences文件。
1 <?xml version="1.0" encoding="utf-8"?> 2 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 3 android:layout_width="fill_parent" 4 android:layout_height="fill_parent" 5 android:background="#00000000"> 6 <LinearLayout 7 android:gravity="center_vertical" 8 android:background="@drawable/preference_mid_background" 9 10 android:layout_width="fill_parent" 11 android:layout_height="wrap_content" 12 > 13 <ImageView 14 android:focusable="false" 15 android:layout_width="wrap_content" 16 android:layout_height="wrap_content" android:src="@drawable/setting_about_us"> 17 </ImageView> 18 <RelativeLayout 19 android:layout_width="wrap_content" 20 android:layout_height="wrap_content" 21 android:layout_marginLeft="15dip" 22 android:layout_marginTop="6dip" 23 android:layout_marginRight="6dip" 24 android:layout_marginBottom="6dip" 25 android:layout_weight="1" 26 > 27 <TextView 28 android:textSize="15dip" 29 android:textColor="#000000" 30 android:ellipsize="marquee" 31 android:id="@+android:id/title" 32 android:fadingEdge="horizontal" 33 android:layout_width="wrap_content" 34 android:layout_height="wrap_content" 35 android:singleLine="true" 36 > 37 </TextView> 38 <TextView 39 android:textAppearance="?android:attr/textAppearanceSmall" 40 android:textColor="#565656" 41 android:id="@+android:id/summary" 42 android:layout_width="wrap_content" 43 android:layout_height="wrap_content" 44 android:maxLines="4" 45 android:layout_below="@+android:id/title" 46 android:layout_alignLeft="@+android:id/title" 47 > 48 </TextView> 49 </RelativeLayout> 50 <ImageView 51 android:focusable="false" 52 android:layout_width="wrap_content" 53 android:layout_height="wrap_content" 54 android:background="@drawable/preference_arrows"/> 55 </LinearLayout> 56 </LinearLayout>
android:background="@drawable/preference_mid_background",通过这一行可以设置这个按钮的点击、选中默认的显示状态,这样可以让你的按钮更加好看。须要在res/drawable中添加xml文件:
android:state_facused
:为控件选中显示
android:state_pressed:为控件按下显示
最后一个为默认显示。
1 <?xml version="1.0" encoding="utf-8"?> 2 <selector 3 xmlns:android="http://schemas.android.com/apk/res/android"> 4 <item 5 android:state_focused="true" 6 android:drawable="@drawable/preference_mid_pressed" 7 > 8 </item> 9 <item 10 android:state_pressed="true" 11 android:drawable="@drawable/preference_mid_pressed" 12 > 13 </item> 14 <item 15 16 android:drawable="@drawable/preference_mid" 17 > 18 </item> 19 20 </selector>
1 import android.content.Context; 2 import android.os.Bundle; 3 import android.preference.Preference; 4 import android.preference.PreferenceActivity; 5 import android.preference.Preference.OnPreferenceClickListener; 6 import android.widget.Toast; 7 8 public class AllActivity extends PreferenceActivity { 9 10 /**自定义布局A**/ 11 Preference preference0 = null; 12 13 /**自定义布局B**/ 14 Preference preference1 = null; 15 16 Context mContext = null; 17 @Override 18 protected void onCreate(Bundle savedInstanceState) { 19 super.onCreate(savedInstanceState); 20 // 从资源文件中添Preferences ,选择的值将会自动保存到SharePreferences 21 addPreferencesFromResource(R.xml.all); 22 mContext = this; 23 24 preference0 = findPreference("pref_key_0"); 25 26 preference0.setOnPreferenceClickListener(new OnPreferenceClickListener() { 27 28 @Override 29 public boolean onPreferenceClick(Preference preference) { 30 Toast.makeText(mContext, "自定义布局A被按下", Toast.LENGTH_LONG).show(); 31 return false; 32 } 33 }); 34 preference1 = findPreference("pref_key_1"); 35 36 preference1.setOnPreferenceClickListener(new OnPreferenceClickListener() { 37 38 @Override 39 public boolean onPreferenceClick(Preference preference) { 40 Toast.makeText(mContext, "自定义布局B被按下", Toast.LENGTH_LONG).show(); 41 return false; 42 } 43 }); 44 } 45 }
7.读取数据
在PreferenceActivity中可以用下面这种方式拿到SharedPreferences中储存的数值,通过PreferenceManager.getDefaultSharedPreferences(this)
方法拿到控件默认储存的sharedPreferences对象。
1 <?xml version=‘1.0‘ encoding=‘utf-8‘ standalone=‘yes‘ ?> 2 <map> 3 <string name="ringtone_!">content://media/external/audio/media/1</string> 4 <string name="ringtone_0">content://media/external/audio/media/1</string> 5 <string name="list_0">1800000</string> 6 <string name="edit_1">请输入信息1212</string> 7 <string name="list">1200000</string> 8 <string name="ringtone">content://settings/system/ringtone</string> 9 <boolean name="checkbox_0" value="true" /> 10 <boolean name="checkbox_1" value="true" /> 11 <string name="edit_0">请输入信息</string> 12 </map>