Preference Activity 实现程序设置界面及参数存储

转载自：http://www.devdiv.com/thread-47027-1-1.html

在开发应用程序的过程中我们有很大的机会需要用到参数设置功能，那么在Android应用中，我们如何实现参数设置界面及参数存储呢，下面我们来介绍一下 Android中的一个特殊Activity–PreferencesActivity。PreferencesActivity是Android中专门用来实现程序设置界面及参数存储的一个Activity，我们用一个实例来简介如何使用PreferencesActivity。

下图是一个参数设置界面：



以此为例我们来介绍一下如何实现这个界面。首先建立一个xml来描述这个界面，文件为res/xml/preferences.xml

<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen
xmlns:android="http://schemas.android.com/apk/res/android">
<PreferenceCategory android:title="PreferenceCategory 1">
<CheckBoxPreference
android:key="CheckBox1"
android:title="CheckBox"
android:summaryOn="某功能: 开启"
android:summaryOff="某功能: 关闭"
android:defaultValue="true"
/>
</PreferenceCategory>
<PreferenceCategory android:title="PreferenceCategory 2">
<PreferenceScreen android:title="二级PreferenceScreen">
<CheckBoxPreference
android:key="CheckBox2"
android:title="CheckBox"
android:summaryOn="某功能: 开启"
android:summaryOff="某功能: 关闭"
android:defaultValue="true"
/>
</PreferenceScreen>
</PreferenceCategory>
<PreferenceCategory android:title="PreferenceCategory 3">
<ListPreference
android:key="ListPreference"
android:title="ListPreference"
android:summary="ListPreference测试"
android:dialogTitle="ListPreference"
android:entries="@array/entries_list_preference"
android:entryValues="@array/entriesvalue_list_preference"
/>
<EditTextPreference
android:key="EditTextPreference"
android:title="EditTextPreference"
android:summary="点击输入"
android:dialogTitle="输入设置"
/>
<RingtonePreference
android:key="RingtonePreference"
android:title="RingtonePreference"
android:summary="选择铃声"
/>
</PreferenceCategory>
</PreferenceScreen>

这个例子中包括了PreferenceActivity中常见的几种组件，以下为具体介绍及用法：

PreferenceScreen：设置页面，可嵌套形成二级设置页面，用Title参数设置标题。

PreferenceCategory：某一类相关的设置，可用Title参数设置标题。

CheckBoxPreference：是一个CheckBox设置，只有两种值，true或false，可用Title参数设置标题，用summaryOn和summaryOff参数来设置控件选中和未选中时的提示。

ListPreference：下拉框选择控件，用Title参数设置标题，用Summary参数设置说明，点击后出现下拉框，用dialogTitle
设置下拉框的标题，下拉框内显示的内容和具体的值需要在res/values/array.xml中设置两个array来表示。图中的array.xml 设置如下：

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string-array name="entries_list_preference">
<item>test1</item>
<item>test2</item>
<item>test3</item>
</string-array>
<string-array name="entriesvalue_list_preference">
<item>1</item>
<item>2</item>
<item>3</item>
</string-array>
</resources>

2011-1-21 18:05:19 上传
下载附件 (19.72
KB)



EditTextPreference：输入框控件，点击后可输入字符串设置。用Title参数设置标题，Summary参数设置说明，dialogTitle参数设置输入框的标题。



以上是PreferenceActivity的xml描述，那么在程序中我们只需要新建一个继承自PreferenceActivity的
Activity，然后在主程序中调用就可以了。这个PreferenceActivity中的设置存储是完全自动的，你不需要再用代码去实现设置的存储，PreferenceActivity创建后会自动创建一个配置文件/data/data/you_package_name /shared_prefs/you_package_name_you_xml_name.xml。上例中自动生成的配置文件如下：

<?xml version='1.0' encoding='utf-8' standalone='yes' ?>
<map>
<string name="EditTextPreference">12332312</string>
<string name="ListPreference">2</string>
<string name="RingtonePreference">content://settings/system/ringtone</string>
<boolean name="CheckBox1" value="true" />
<boolean name="CheckBox2" value="true" />
</map>

要取得其中的值可以通过如下的方法：

SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences(this);
value = prefs.getString(”ListPreference”, “unset”);

设计自己的Android Preference

SeekBar Preference

Android提供了Preference供应用可以进行功能设置以及属性配置等操作，检查android.preference可以看到
Preference下有若干子类，例如常用的EditTextPreference、CheckBoxPreference、 ListPreference等。但是仅仅有这些是不够的。

在我现在的工作当中，应用里有这么一个场景，用户手指在屏幕滑动，应用绘制出移动的轨迹。

熟悉Android API Demo(可以在SDK/platforms/android-1.5/samples下找到)的人一定记得在graphics目录下，有一个 FingerPaint的类实现了类似上述功能。但是还远远实现不了我们的需要，–需求是要在Preference中实现挑选颜色和调整粗细。

当然，他山之石可以攻玉，FingerPaint还是提供了不错的例子，尤其是FingPaint中选择颜色所使用的另外一个类ColorPickerDialog基本上具备了我们想要的部分功能。

除了上面提到的FingerPaint之外，还可以从Android的源码中找到可以参考的代码。从framework/base/core /java中，找到android.preference包，可以看到有一个SeekBarPreference的类，–这是一个“烂尾”类，代码未完成，因此被Google打上了@hide的标签。因此需要稍加完善，才能加以使用。

@Override
protected void onBindDialogView(View view) {
super.onBindDialogView(view);

bar = (SeekBar) view.findViewById(R.id.seekbar);
bar.setOnSeekBarChangeListener(this);
bar.setProgress(barValue);
}

public void setValue(int value) {
barValue = value;
}

public int getValue() {
return barValue;
}

@Override
protected void onDialogClosed(boolean positiveResult) {
if (positiveResult) {
this.getOnPreferenceChangeListener().onPreferenceChange(this, barValue);
}
}

Color Picker Preference



Color Picker Preference

在这个类的改造过程中，override两个父类方法是关键所在，一个是onBindDialogView，另一个是onDialogClosed。

通过第一个方法，我们可以“找到”被当做content view的SeekBar的实例，进而可以获得到其progress。

通过第二个方法，我们可以方便的通知到Listener，告诉它，SeekBar的值有变化。这里我们把SeekBar的值，即progress 看做是SeekBarPreference的value。除了这两个方法之外，就是要增加setValue和getValue两个方法了。

如果不看代码的话，就会有疑问：SeekBar是如何进入Diglog的呢？它正式通过DialogPreference的属性android:dialogLayout得以注入：

<net.poemcode.android.config.SeekBarPreference
android:key="@string/setting_handwrite_width_key"
android:title="@string/setting_handwrite_width_title"
android:dialogTitle="@string/setting_handwrite_width_title"
android:dialogLayout="@layout/setting_widthseekbar"
android:persistent="true"/>

依此原理，可以举一反三，对于如何实现选择颜色是不是有了思路？

首先实现一个视图，负责展现不同颜色和接收用户选中的颜色，其可以从SeekBarPreference中的内部类 ColorPickerView加以改造完成；然后新增一个布局文件，将刚才的视图加入到布局当中；接着继承DialogPreference实现自己的 Preference子类ColorPickerPreference；最后在XML文件里增加这个Preference并把刚才的布局文件通过 dialogLayout属性加入进去。从而实现了整个功能。

public class SeekBarPreference extends DialogPreference implements SeekBar.OnSeekBarChangeListener {

private static final String TAG = "SeekBarPreference";

private SeekBar bar;

private int barValue;

public SeekBarPreference(Context context, AttributeSet attrs) {
super(context, attrs);
}

@Override
protected void onBindDialogView(View view) {
super.onBindDialogView(view);

bar = (SeekBar) view.findViewById(R.id.seekbar);
bar.setOnSeekBarChangeListener(this);
bar.setProgress(barValue);
}

public void setValue(int value) {
barValue = value;
}

public int getValue() {
return barValue;
}

@Override
protected void onDialogClosed(boolean positiveResult) {
if (positiveResult) {
this.getOnPreferenceChangeListener().onPreferenceChange(this, barValue);
}
}

public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
Log.d(TAG, "onProgressChanged, progress : " + progress + ", fromUser : " + fromUser);
}

public void onStartTrackingTouch(SeekBar seekBar) {
Log.d(TAG, "onStartTrackingTouch");
}

public void onStopTrackingTouch(SeekBar seekBar) {
barValue = seekBar.getProgress();
}
}