Preferences入门

2024-05-14 00:32
文章标签 入门 preferences

本文主要是介绍Preferences入门，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

概述

        在应用中经常会包含"设置"界面，该界面允许用户进行一些选择，从而更改应用的外观等。用户在"设置"界面更改之后的值通常保存在SharedPreferences中，但是如果自己通过代码实现的话，就得自己操作SP去存储。为了简化使用，可以使用Android自带的Preferences。虽然它内部使用的也是SP，但是不需要我们在用户更改设置后手动存储。

        与传统的界面相比，使用Preferences时也需要Activity，也需要写xml文件。但该xml文件并不是存储在res/layout下的，而是一定要存储在res/xml文件中。并且在创建界面时，并不是使用View及其子类，而是使用Preferences及其子类。

        每一个Preferences都需要一个键值对，这些键值对是存储在系统默认的SP中。当用户更改了相应的设置时，系统会自动更新默认的SP中的值。因此，在别处使用sp时取到的就是最新的值。

        为了使用Preferences，Activity必须继承PreferenceActivity（如果系统3.0以后，可使用PreferenceFragment）。常用的Preferences有EditTextPreference，CheckBoxPreference与ListPreference。如果界面展示的条目过多时，可以使用PreferenceCategory进行组或者使用PreferenceScreen进行分屏。

常用属性

        key：基本上所有的Preferences都需要。系统将数据存储到默认sp中时，就使用该属性的值做为sp中的key值。只有在下列三种情况下不需要该属性：1，节点为<PreferenceScreen>或者<PreferenceCategory>；2，当前的结点指定了<intent>属性；3，当前的结点通过一个Fragment展示时。

        title，summary：展示给用户的提示信息，相当于标题和副标题。

        defaultValue：默认值。如果用户没有修改该属性时，sp中存储的值。

常用Preferences

PreferenceScreen

        重新打开一个界面展示其包含的item。如：

    <PreferenceScreenandroid:persistent="false"android:title="PreferenceScreen" ><Preferenceandroid:key="button_voicemail_provider_key"android:title="我好饿啊...." /><PreferenceScreenandroid:key="button_voicemail_setting_key"android:persistent="false"android:title="我非常的饿啊...." ><Preferenceandroid:key="button_voicemail_provider"android:title="第二页我好饿啊....1" /><Preferenceandroid:key="button_voicemail_provider"android:title="第二页我好饿啊....2" /></PreferenceScreen></PreferenceScreen>
        在第一个界面中会有一个条目显示的文字是"PreferenceScreen"(因为外层的PreferenceScreen的title属性值是该值)，点击该item时会重新打开一个界面。第二个界面上显示的就是"我好饿啊..."及"我非常的饿啊..."。当再点击"我非常的饿啊..."时又会显示一个界面，里面显示的就是"第二页xxxx"。

        从这可以看出，PreferenceScreen的title显示会展示在前一个界面中。当点击时，会启动一个新界面，新界面展示的内容便是PreferenceScreen所包含的内容。

PreferenceCategory

        类似于PreferenceScreen，但不会启动新界面，它只是将item分组，并且每一个上面显示PreferenceCategory的title属性值。

CheckBoxPreference

        展示的item中含有一个checkbox，并且将boolean存储到sp中时(如果被选中存储的就是true)。

ListPreference

        打开一个单选对话框。它支持的类型(也就是能存储的数据类型)为：boolean，int，float，long以及String。

属性

        dialogTitle：显示的对话框的标题。

        entries：显示的对话框中的列表项。

        entryValues：当用户选择entries中某一项时，存储到sp中的值。

EditTextPreference

        打开一个只含有EditText的对话框，它只支持String类型。

常用操作

加载xml

        在activity继承PreferenceActivity后，重写onCreate()并调用addPreferencesFromResource()即可。示例：

public class PreferencesFromXml extends PreferenceActivity {@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);// Load the preferences from an XML resourceaddPreferencesFromResource(R.xml.preferences);}
}

        也可以使用PreferenceFragment，定义好的PreferenceFragment就跟平时使用Fragment一样。示例如下:

public static class SettingsFragment extends PreferenceFragment {@Overridepublic void onCreate(Bundle savedInstanceState) {//在onCreate中调用addPreferencesFromResource(0super.onCreate(savedInstanceState);// Load the preferences from an XML resourceaddPreferencesFromResource(R.xml.preferences);}}

获取存储的值

        存储时不需要通过代码进行操作，系统会自动存储到默认的sp中。因此，取值的时候只能从默认的sp中取。示例：

				//获取默认的sp,得到是SharedPreferences对象mPreferences = PreferenceManager.getDefaultSharedPreferences(SecondActivity.this);if (mPreferences.contains("pref_sync")) {//从默认的sp中获取值boolean b = mPreferences.getBoolean("pref_sync", false);System.out.println("b = " + b);String string = mPreferences.getString("pref_syncConnectionType", "default");System.out.println(string);}

        在取值时，传入getXXX方法中的key值是定义在xml文件中的key属性的值。

打开新activity

        Preference结点下可以使用<intent>标签，通过该标签可以打开别的activity。如下：

    <Preferenceandroid:title="打开第二个activity" ><intentandroid:targetClass="com.baigle.customview.SecondActivity"android:data="xxdata"android:targetPackage="com.baigle.customview" /></Preference>

        <intent>标签下的android:action,android:mimeType与android:data分别相当于Intent.setAction(),Intent.setType()及Intent.setData()。

添加默认值

        虽然在xml文件中指定了defaultValue属性，但系统并不会在程序一运行时就将defaultValue存储到sp中，它只会在加载到关联该xml的界面时才会存储默认值。为此,可以在别的界面中调用PreferenceManager.setDefaultValues()提前将默认值存储到sp中。

        该方法有三个参数，前两个不说，单说第三个，该参数表明是否可以重新将sp中的值还原成默认值。如果该值为true，那么无论何时调用该方法，都会将sp中的值还原成默认值，即使用户已经修改过。如果该值为false，则不会出现上述情况，故当第三个参数为false时，可以很安全地多次调用该方法。

        一般会在应用的入口activity的onCreate()中调用该方法，包括main Activity及别的可以进入到应用的activity。

保存

        当用户选择完毕时，需要将用户的选择进行保存。Preference有一系列persisXXX方法用于保存数据，只要在适合的地方保存就行。比如DialogPreference中的onDialogClosed()中。

        如果在Preference中获取保存的数据，可以通过getPersistedXXX系列方法进行获取。

Preference Headers

概述

        在很多时候，可能需要一个界面展示列表。用户点击某个条目后才展示具体的设置。具体设置的展示方式有两种：如果屏幕不够宽就重新开启一个新屏幕；如果屏幕够宽，可以在屏幕的剩余部分展示。具体如下面的图（来自谷歌官方文档）



        为实现上述的情况，可以使用Preferences Header。虽然当屏幕不够宽的时候可以使用Preference Screen，但是没办法实现屏幕够宽时的要求。

步骤

        1，每一组设置都用一个PreferenceFragment。

        2，创建header文件，并且声明它所关联的PreferenceFragment。

        3，创建一个PreferenceActivity用来承载header文件，并且重写其中的onBuildHeaders()。此时不需要重写onCreate()，也不需要调用addPreferencesFromResource()。

示例

header文件

<preference-headers xmlns:android="http://schemas.android.com/apk/res/android" ><headerandroid:fragment="com.baigle.customview.SecondFragment"android:summary="Header1Summary"android:title="Header1Title" ><extraandroid:name="someKey"android:value="one" /></header><headerandroid:fragment="com.baigle.customview.SecondFragment"android:summary="Header2Summary"android:title="Header2Title" ><extraandroid:name="someKey"android:value="two" /></header>
</preference-headers>
        header文件的根元素必须是preference-headers，每一个header元素都指向了一个item，并且通过header元素下的fragment属性指向了要展示的PreferenceFragment。

        header元素下的extra元素可以向关联的PreferenceFragment中传递数据。在上面的例子中，两个fragment属性指定的是同一个PreferenceFragment。但是可以通过extra元素中的value属性值使fragment加载不同的界面。
fragment示例如下:

public class SecondFragment extends PreferenceFragment {@Overridepublic void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);String key = getArguments().getString("someKey");if ("one".equalsIgnoreCase(key)) {//根据value的值加载不同的xml文件addPreferencesFromResource(R.xml.preference_one);} else if ("two".equalsIgnoreCase(key)) {addPreferencesFromResource(R.xml.preference_two);}}
}
承载header文件的activity示例如下： 
public class MainActivity extends PreferenceActivity {//不需要重写onCreate()，只需要重写该方法即可public void onBuildHeaders(List<Header> target) {loadHeadersFromResource(R.xml.header_test, target);}
}

兼容

        由于header是3.0以后引起来的，如果在3.0以前使用想使用类似于header，可以按以下方法进行。具体思路为：

利用Preference和intent元素模拟header效果。示例如下：

<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android" ><Preferenceandroid:summary="Header1Summary"android:title="Header1Title" ><intentandroid:action="one"android:targetClass="com.baigle.customview.MainActivity"android:targetPackage="com.baigle.customview" /></Preference><Preferenceandroid:summary="Header2Summary"android:title="Header2Title" ><intentandroid:action="two"android:targetClass="com.baigle.customview.MainActivity"android:targetPackage="com.baigle.customview" /></Preference>
</PreferenceScreen>
        这里面的intent元素始终指向同一个activity，只是每一次传递的action不同，这是为了在activity加载不同的preference XML，与<extra>中的value值不同是同一个目的。

承载的activity

public class MainActivity extends PreferenceActivity {private final String ACTION_ONE = "one";private final String ACTION_TWO = "two";@SuppressWarnings("deprecation")protected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);System.out.println("oncreate。。。。");String action = getIntent().getAction();if (ACTION_ONE.equalsIgnoreCase(action)) {addPreferencesFromResource(R.xml.preference_one);} else if (ACTION_TWO.equalsIgnoreCase(action)) {addPreferencesFromResource(R.xml.preference_two);} else if (Build.VERSION.SDK_INT < Build.VERSION_CODES.HONEYCOMB) {addPreferencesFromResource(R.xml.header_legacy);}}@SuppressLint("NewApi")public void onBuildHeaders(List<Header> target) {loadHeadersFromResource(R.xml.header_test, target);}
}
        与不兼容之前相比，重写了onCreate()，并在onCreate()中根据action和版本号加载不同的XML文件。同时也重写了onBuildHeaders()。

        由于onBuildHeaders()是3.0以后添加的，所以在3.0以前该方法不会被调用，只有3.0以后才会调用。同时在onCreate()中，当版本高于3.0时没有加载任何XML文件。这样就兼容了低版本与高版本：低于3.0时在onCreate()中加载了XML文件，此时不会执行onBuildHeaders()；高于3.0时在onBuildHeaders加载xml文件，此时onCreate()中没有加载任何XML文件。这也是兼容低版本的一个方法：根据版本号不同，调用不同的方法。

自定义

常用方法

        onCreateView()：创建item显示界面。

        onBindView()：为onCreateView()创建的界面绑定数据。比如采取一些XML文件中的title，summary之类的属性值，便设置到界面上。

        onClick()：用来处理该条目的点击事件。如果想要执行onClick()方法，onCreateView()中的布局中的组件必须不能有焦点，也不能设置成clickable为true。

        onGetDefaultValue()：主要用于获取默认值(android:defaultValue属性的值)。如果继承Preference时，该方法必须重写。它是在构造方法中调用的，因此该方法比onCreateView()与onBindView()先执行。如：

	@Overrideprotected Object onGetDefaultValue(TypedArray a, int index) {defaultValue = a.getInt(index, DEFAULT_MIN);//直接使用a.get*()即可。return defaultValue;}
        onSetInitialValue()：在该方法中主要可以做：将android:defaultValue属性的值存储到sp中，获取sp中存储的值(如果没有存储过，就显示android:defaultValue属性的值)方便初始化当前的显示。在onGetDefaultValue()后调用。

        当第一个参数为false时，第二个参数就是onGetDefaultValue()的返回值，因此可以在此时将android:defaultValue属性的值存储到sp中；第一个参数是true时，第二个参数为null。该方法有时候不执行，可能是因为onGetDefaultValue()返回的是null。如下：

	@Overrideprotected void onSetInitialValue(boolean restorePersistedValue,Object defaultValue) {if (restorePersistedValue) {//为true时，就从sp中取出原来存储过的值mCurrentValue = this.getPersistedInt(mDefaultValue);} else {//将默认值设置成当前值。并且通过persist*()将默认值存储到sp中mCurrentValue = (Integer) defaultValue;persistInt(mCurrentValue);// 保存anddroid:defaultValue属性的值}}

继承DialogPreference

        虽然可以直接继承Preference，但是继承DialogPreference是一个更好的方法。它提供了一个item界面，并且当点击item时会弹出一个dialog。
        继承DialogPreference时，不需要重写上面三个方法，可以重写DialogPreference类中自身的三个方法，依次为：onCreateDialogView()，onBindDialogView()与onDialogClosed()。前两个方法类似于onCreateView()与onBindView()，最后一个方法是dialog关闭时用于保存数据的地方。不需要重写onClick()。
        对于onCreateDialogView()与onBindDialogView()，每一次弹出dialog时都会调用一次。
        onDialogClosed()中的参数表示用户是不是点击了"确定"按键，只有当点击的是确定时才需要保存数据，否则不需要。

自定义属性

        方法与自定义View时一样，使用的时候也一样。如下：

    <declare-styleable name="CustomPreference"><attr name="maxValue" format="integer" /><attr name="defaultValue" format="integer" /></declare-styleable>

获取自定义属性值

        也与自定义View时一样，都是在构造方法中获取。如下： 
	public CustomPreference(Context context, AttributeSet attrs) {super(context, attrs);TypedArray array = context.obtainStyledAttributes(attrs,R.styleable.CustomPreference);for (int x = 0; x < array.getIndexCount(); x++) {int index = array.getIndex(x);switch (index) {case R.styleable.CustomPreference_maxValue:maxValue = array.getInteger(index, DEFAULT_MAX);break;case R.styleable.CustomPreference_defaultValue:defaultValue = array.getInteger(index, DEFAULT_MIN);break;default:break;}}array.recycle();}

重写三个方法

	/*** 创建dialog的content内容*/protected View onCreateDialogView() {//也可以直接在构造方法中调用setDialogLayoutResource()而不需要重写该方法mCurrentValue = getPersistedInt(defaultValue);final LayoutInflater layoutInflater = (LayoutInflater) getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE);final View layout = layoutInflater.inflate(R.layout.activity_second,null);return layout;}/*** 绑定数据*/protected void onBindDialogView(View view) {mCurrentValue = getPersistedInt(defaultValue);//获取已经存储的值final TextView tv_current = (TextView) view.findViewById(R.id.button1);SeekBar sb = (SeekBar) view.findViewById(R.id.button2);sb.setMax(maxValue);sb.setProgress(mCurrentValue);tv_current.setText(String.valueOf(mCurrentValue));sb.setOnSeekBarChangeListener(new OnSeekBarChangeListener() {public void onStopTrackingTouch(SeekBar seekBar) {}public void onStartTrackingTouch(SeekBar seekBar) {}@Overridepublic void onProgressChanged(SeekBar seekBar, int progress,boolean fromUser) {tv_current.setText(String.valueOf(progress));mCurrentValue = progress;}});}/*** 当dialog关闭时会调用该方法，此时可以用于存储数据*/protected void onDialogClosed(boolean positiveResult) {if (positiveResult) {//为true时表示用户点击的是确定，所以保存数据；否则不保存persistInt(mCurrentValue);//保存当前的值}}

示例

<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android" ><CheckBoxPreferenceandroid:defaultValue="true"android:key="pref_sync"android:summary="CheckBoxPreferenceSummary"android:title="CheckBoxPreferenceTitle" /><ListPreferenceandroid:defaultValue="ListPreferenceDefaultValue"android:dependency="pref_sync"android:dialogTitle="ListPreferenceDialogTitle"android:entries="@array/pref_syncConnectionTypes_entries"android:entryValues="@array/pref_syncConnectionTypes_values"android:key="pref_syncConnectionType"android:title="ListPreferenceTitle" />
</PreferenceScreen>
        与第一段代码对比着看，每一个<Preferences>节点指定的key属性的值就是getXXX()时的第一个参数的值。

这篇关于Preferences入门的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/987241。

相关文章

Spring Security 从入门到进阶系列教程

Spring Security 从入门到进阶系列教程

Spring Security 入门系列 《保护 Web 应用的安全》 《Spring-Security-入门（一）：登录与退出》 《Spring-Security-入门（二）：基于数据库验证》 《Spring-Security-入门（三）：密码加密》 《Spring-Security-入门（四）：自定义-Filter》 《Spring-Security-入门（五）：在 Sprin
阅读更多...
数论入门整理（updating）

数论入门整理（updating）

一、gcd lcm 基础中的基础，一般用来处理计算第一步什么的，分数化简之类。 LL gcd(LL a, LL b) { return b ? gcd(b, a % b) : a; } <pre name="code" class="cpp">LL lcm(LL a, LL b){LL c = gcd(a, b);return a / c * b;} 例题：
阅读更多...
Java 创建图形用户界面（GUI）入门指南（Swing库 JFrame 类）概述

Java 创建图形用户界面（GUI）入门指南（Swing库 JFrame 类）概述

概述 基本概念 Java Swing 的架构 Java Swing 是一个为 Java 设计的 GUI 工具包，是 JAVA 基础类的一部分，基于 Java AWT 构建，提供了一系列轻量级、可定制的图形用户界面（GUI）组件。 与 AWT 相比，Swing 提供了许多比 AWT 更好的屏幕显示元素，更加灵活和可定制，具有更好的跨平台性能。 组件和容器 Java Swing 提供了许多
阅读更多...
【IPV6从入门到起飞】5-1 IPV6+Home Assistant(搭建基本环境)

【IPV6从入门到起飞】5-1 IPV6+Home Assistant(搭建基本环境)

【IPV6从入门到起飞】5-1 IPV6+Home Assistant #搭建基本环境 1 背景2 docker下载 hass3 创建容器4 浏览器访问 hass5 手机APP远程访问hass6 更多玩法 1 背景 既然电脑可以IPV6入站，手机流量可以访问IPV6网络的服务，为什么不在电脑搭建Home Assistant（hass），来控制你的设备呢？@智能家居 @万物互联
阅读更多...
poj 2104 and hdu 2665 划分树模板入门题

poj 2104 and hdu 2665 划分树模板入门题

题意： 给一个数组n（1e5）个数，给一个范围（fr， to， k），求这个范围中第k大的数。 解析： 划分树入门。 bing神的模板。 坑爹的地方是把-l 看成了-1........ 一直re。 代码： poj 2104： #include <iostream>#include <cstdio>#include <cstdlib>#include <al
阅读更多...
MySQL-CRUD入门1

MySQL-CRUD入门1

文章目录 认识配置文件client节点mysql节点mysqld节点 数据的添加(Create)添加一行数据添加多行数据两种添加数据的效率对比 数据的查询(Retrieve)全列查询指定列查询查询中带有表达式关于字面量关于as重命名 临时表引入distinct去重order by 排序关于NULL 认识配置文件 在我们的MySQL服务安装好了之后, 会有一个配置文件, 也就
阅读更多...
音视频入门基础：WAV专题（10）——FFmpeg源码中计算WAV音频文件每个packet的pts、dts的实现

音视频入门基础：WAV专题（10）——FFmpeg源码中计算WAV音频文件每个packet的pts、dts的实现

一、引言 从文章《音视频入门基础：WAV专题（6）——通过FFprobe显示WAV音频文件每个数据包的信息》中我们可以知道，通过FFprobe命令可以打印WAV音频文件每个packet（也称为数据包或多媒体包）的信息，这些信息包含该packet的pts、dts： 打印出来的“pts”实际是AVPacket结构体中的成员变量pts，是以AVStream->time_base为单位的显
阅读更多...
C语言指针入门 《C语言非常道》

C语言指针入门 《C语言非常道》

C语言指针入门 《C语言非常道》 作为一个程序员，我接触 C 语言有十年了。有的朋友让我推荐 C 语言的参考书，我不敢乱推荐，尤其是国内作者写的书，往往七拼八凑，漏洞百出。 但是，李忠老师的《C语言非常道》值得一读。对了，李老师有个官网，网址是： 李忠老师官网 最棒的是，有配套的教学视频，可以试看。 试看点这里 接下来言归正传，讲解指针。以下内容很多都参考了李忠老师的《C语言非
阅读更多...
MySQL入门到精通

MySQL入门到精通

一、创建数据库 CREATE DATABASE 数据库名称; 如果数据库存在，则会提示报错。 二、选择数据库 USE 数据库名称; 三、创建数据表 CREATE TABLE 数据表名称; 四、MySQL数据类型 MySQL支持多种类型，大致可以分为三类：数值、日期/时间和字符串类型 4.1 数值类型 数值类型 类型大小用途INT4Bytes整数值FLOAT4By
阅读更多...
【QT】基础入门学习

【QT】基础入门学习

文章目录 浅析Qt应用程序的主函数使用qDebug()函数常用快捷键Qt 编码风格信号槽连接模型实现方案 信号和槽的工作机制Qt对象树机制 浅析Qt应用程序的主函数 #include "mywindow.h"#include <QApplication>// 程序的入口int main(int argc, char *argv[]){// argc是命令行参数个数，argv是
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2