Android之PreferenceActivity

最新推荐文章于 2013-08-16 00:54:31 发布

lxmhuendan

最新推荐文章于 2013-08-16 00:54:31 发布

阅读量975

点赞数

分类专栏：杂七杂六文章标签： android structure null internet layout xml

杂七杂六专栏收录该内容

176 篇文章 2 订阅

订阅专栏

Android之PreferenceActivity

分类： Android 2011-05-06 09:39

看到很多书中都没有对PreferenceActivity做介绍，而我正好又在项目中用到，所以就把自己的使用的在这总结一下，也方便日后查找。

PerferenceActivity是什么，看下面的截图：

Android系统截图

MusicPlayer Setting截图

好了，我们看到Android系统本身就大量用到了PreferenceActivity来对系统进行信息配置和管理，那么它是怎么保存数据的呢，如何创建PrefenceActivity的呢，更关键是怎样触发相应事件的呢。

先看第一个问题，PreferenceActivity是如何保存的数据。对Android系统了解的都知道，Android系统有四种基本的数据保存方法，一是SharedPreference，二是文件，三是SQLite,四是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按钮，在打开的新窗口中可以看到以下几项：

CheckBoxPreference:CheckBox选择项，对应的值的ture或flase。如图：

EditTextPreference:输入编辑框，值为String类型，会弹出对话框供输入。

ListPreference: 列表选择，弹出对话框供选择。

Preference：只进行文本显示，需要与其他进行组合使用。

PreferenceCategory：用于分组。效果如下:

PreferenceScreen:PreferenceActivity的根元素，必须为它。

RingtonePreference：系统玲声选择。

OK，Preferenc的基本元素介绍完毕，下一节将使用它们创建一个完整的Preference并进行显示。

-------------------------------------------------------------------------------

分析MusicPlayer Setting，第一部分为“我的位置”，包括“使用无线网线”和“使用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>

以上代码当然也可以用Android提供的IDE工具直接生成。视频结构如下：

PreferenceCategory属性分析：

title:显示的标题

key：唯一标识（至少在同一程序中是唯一），SharedPreferences也将通过此Key值进行数据保存,也可以通过key值获取保存的信息 (以下相同）。

CheckBoxPreference属性分析：

Key：唯一标识.

title：显示标题（大字体显示）

summary:副标题（小字体显示）

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>

对应的Structure图：

第二部分中前三个都为CheckBoxPreference，不心多说，从<Preference android:key="bluetooth_setting"/>开始。

Preference属性分析：

Key：唯一标识.

title：显示标题（大字体显示）

summary:副标题（小字体显示）

dependency：附属（嘛意思），即标识此元素附属于某一个元素（通常为CheckBoxPreference)，dependency值为所附属元素的key。上面代码中的Preference元素附属于key等于“apply_bluetooth”的CheckPreference元素，当 CheckPreference值为true时，Preference则为可用，否则为不可用。

EditTextPreperence属性分析：

Key：唯一标识.

title：显示标题（大字体显示）

ListPreference属性分析：

Key：唯一标识.

title：显示标题（大字体显示）

dialogTitle：弹出对话框的标题

entries：列表中显示的值。为一个数组，通读通过资源文件进行设置。

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>

RingtonePreference ：玲声（暂时没有用到过），暂时略过。

OK,Preference.xml内容已经分析完毕，属性都大致相同，相信亲自动力一试也就那么回事。那么如何把Preference.xml中内容展现出来呢？

Layout是通过继续自Activity的类来进行显示的，前面提到过，PreferenceActivity是专门用于显示preference的，所以只要创建一个继承自PreferenceActivity类即可。代码如下：

public class Setting extends PreferenceActivity {
	@Override
	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		// 所的的值将会自动保存到SharePreferences
		addPreferencesFromResource(R.xml.preference);
	}
}

接下来就是运行程序，显示劳动成果。至此，工作已经完成大半，所有的值都会保存到SharedPreferences中，我们也可以读取到保存的结果。

还有一个重要的问题，就是如何响应PreferenceActivity的操作。其实只要重写PreferenceActivity的 onPreferenceTreeClick的方法就可以了，通过参数preference来判断是对那一个元素进行的，并根据需要进行操作。

@Override

public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen,
		Preference preference) {
	return false;
}

获取配置信息

　　为了方便的获取配置信息，我们可以在PreferenceActivity里添加一些pulbic 方法来公开配置信息的访问。

 /**
     * 获取是否播放声音
     */
    public static boolean playSounds(Context context) {
        return PreferenceManager.getDefaultSharedPreferences(context).getBoolean(SOUNDS, SOUNDS_DEFAULT);
    }
    
    /**
     * 设置播放的声音
     * @param context 上下文
     * @param value 是否播放
     */
    public static void setPlaySounds(Context context, boolean value) {
        PreferenceManager.getDefaultSharedPreferences(context).edit().putBoolean(SOUNDS, value).commit();
    }
    
    /**
     * 获取警告时间
     * @param context 上下文
     * @return 警告时间秒
     */
    public static int getWarningTime(Context context) {
        String value=PreferenceManager.getDefaultSharedPreferences(context).getString(WARNING_TIME,Integer.toString(WARNING_TIME_DEFAULT));
        try
        {
            return Integer.parseInt(value);
        }
        catch(NumberFormatException e)
        {
             setWarningTime(context, WARNING_TIME_DEFAULT);
             return WARNING_TIME_DEFAULT;
        }
        
    }
    
    /**
     * 设置警告时间
     * @param context 上下文
     * @param warningTime 警告时间
     */
    public static void setWarningTime(Context context, int warningTime) {
     PreferenceManager.getDefaultSharedPreferences(context).edit().putString(WARNING_TIME, Integer.toString(warningTime)).commit();
     
    }
    
    

    /**
     * 参加人数无限制
     * @param context
     * @return
     */
    public static boolean allowUnlimitedParticipants(Context context) {
        return PreferenceManager.getDefaultSharedPreferences(context).getBoolean(UNLIMITED_PARTICIPANTS, UNLIMITED_PARTICIPANTS_DEFAULT);
    }

    public static void setAllowUnlimitedParticipants(Context context, boolean value) {
        PreferenceManager.getDefaultSharedPreferences(context).edit().putBoolean(UNLIMITED_PARTICIPANTS, value).commit();
    }

    /**
     * 允许编辑会议时间
     * @param context
     * @return
     */
    public static boolean allowVariableMeetingLength(Context context) {
        return PreferenceManager.getDefaultSharedPreferences(context).getBoolean(VARIABLE_MEETING_LENGTH, VARIABLE_MEETING_LENGTH_DEFAULT);
    }

    public static void setAllowVariableMeetingLength(Context context, boolean value) {
        PreferenceManager.getDefaultSharedPreferences(context).edit().putBoolean(VARIABLE_MEETING_LENGTH, value).commit();
    }
    
getDefaultSharedPreferences(Context )用来获取preferences.以后的操作就和普通的Sharedpreferences一样了，如果需要修改某项配置的信息，记得最后需要 commit()。

当其他地方需要使用配置时，可以直接调用 setting.getXXX() 方法来获取配置信息。

今天主要研究了一下设置中的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有关，有时候我们会重写这个方法如：

    public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen, Preference preference) {

       if ( (preference == mAirplaneModePreference) &&

                (Boolean.parseBoolean(

                    SystemProperties.get(TelephonyProperties.PROPERTY_INECM_MODE))) ) {

            // In ECM mode launch ECM app dialog

           startActivityForResult(

                new Intent(TelephonyIntents.ACTION_SHOW_NOTICE_ECM_BLOCK_OTHERS, null),

                REQUEST_CODE_EXIT_ECM);

            return true;

        }

        else {

            // Let the intents be launched by the Preference manager

            return false;

       }

    }

其中WirelessSetting.java中有如上函数,当返回值为true时,你怎么点击Preference都不会跳转到activity的，只
有等到它的返回值为false的时候，才可以正常跳转，因为点击某一个Preference的真正实现在Preference.java的
performClick函数中如下：

void performClick(PreferenceScreen preferenceScreen) {

        

        if (!isEnabled()) {

            return;

        }

        

        onClick();

        

        if (mOnClickListener != null && mOnClickListener.onPreferenceClick(this)) {

            return;

        }

        

        PreferenceManager preferenceManager = getPreferenceManager();

        if (preferenceManager != null) {

            PreferenceManager.OnPreferenceTreeClickListener listener = preferenceManager

                    .getOnPreferenceTreeClickListener();

            if (preferenceScreen != null && listener != null

                    && listener.onPreferenceTreeClick(preferenceScreen, this)) {

                return;

            }

        }

        

        if (mIntent != null) {

            Context context = getContext();

            context.startActivity(mIntent);

        }

    }

当点击某个Preference时的调用流程是AdapterView.performItemClick－－》
PreferenceScreen.onItemClick－－》Preference.performClick－－》
PreferenceActivity.onPreferenceTreeClick，当onPreferenceTreeClick返回true的时候
就直接return了，没有走下面启动activity的地方了，因此要使一个Preference能够正常跳转到另外一个activity有两个条件，


将你自己的Preference Screen共享出来

<intent-filter>

</intent-filter>

</activity>