Android之PreferenceActivity (转载)

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

PerferenceActivity是什么,看下面的截图:

Android之PreferenceActivity (转载)_第1张图片            Android之PreferenceActivity (转载)_第2张图片

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.

             Android之PreferenceActivity (转载)_第3张图片

添加完成之后,在res/xml/下打开添加的preference.xml文件。可以看到Android也为我们提供两种编辑模式,可视化的结构设计及xml源码设计。推荐使用structure进行创建。如图所示:

       Android之PreferenceActivity (转载)_第4张图片

下面我们看看PrefeneceActivity都提供了哪几种元素可供使用。点击Add按钮,在打开的新窗口中可以看到以下几项:

              Android之PreferenceActivity (转载)_第5张图片

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

            image

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

Android之PreferenceActivity (转载)_第6张图片 

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

Android之PreferenceActivity (转载)_第7张图片 

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

           image

 

 

 

 

 

 

 

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

          image

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

 

RingtonePreference:系统玲声选择。

         Android之PreferenceActivity (转载)_第8张图片

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工具直接生成。视频结构如下:

      image 
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图:

         Android之PreferenceActivity (转载)_第9张图片

第二部分中前三个都为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中保存的设置时,可以直接在其他Activity中调用:
SharedPreferences settings=PreferenceManager.getDefaultSharedPreferences(this);
//使用默认的defaultSharedPreferences,也就是xml的文件名是packageName,
settings.getBoolean("apply_fly",false);

 

Ok,到此关于PreferenceActvity的想关内容就完了,日后有什么重大发现会补上。

 

 

 

获取配置信息

  为了方便的获取配置信息,我们可以在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共享出来
   <activity android:name=".UserPreferences" android:label="Earthquake Preferences">
      <intent-filter>
         <action android:name="com.paad.myapp.ACTION_USER_PREFERENCE" />
      </intent-filter>
   </activity>
一是xml里面是否设置正确,第二是调用该xml的java类是否在onPreferenceTreeClick这个函数需要返回false

你可能感兴趣的:(Android之PreferenceActivity (转载))