当前位置:   article > 正文

Android PreferenceScreen的使用和详解(设置页面)

preferencescreen

PreferenceScreen是设置选项的配置文件,一般用在设置页面,用来当前的状态是保存在。该状态无须用户处理,存在SharedPreferences中。

1.如何使用

1.1布局文件的创建

PreferenceScreen的用法和layout的类似,都是通过xml文件来管理的,但是PreferenceScreen的布局需要自己去创建

在/main/res/xml夹下新建preferences.xml文件,文件的根布局PreferenceScreen节点。

配置如下

<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">

    <SwitchPreferenceCompat
        app:key="notifications"
        app:title="Enable message notifications" />

    <Preference
        app:key="feedback"
        app:summary="Report technical issues or suggest new features"
        app:title="Send feedback" />

    <SwitchPreference
        app:key="SwitchPreference"
        app:title="SwitchPreference" />

    <CheckBoxPreference
        android:key="CheckBoxPreference"
        app:title="CheckBoxPreference" />


    <ListPreference
        app:key="ListPreference"
        android:entries="@array/mode_80211_selection_entries"
        android:entryValues="@array/mode_80211_selection_values"
        app:title="ListPreference" />


</PreferenceScreen>

布局的预览

PreferenceScreen支持以下几种:

1.ListPreference:
2.DropDownPreference
3.CheckBoxPreference
4.SwitchPreference
5.SwitchPreferenceCompat
6.EditTextPreference
7.MultiSelectListPreference
8.Preference
9.PreferenceCategory
10.PreferenceScreen
11.SeekBarPreference

2.使用:

我们知道了PreferenceScreen大概,接下来介绍如何使用

2.1Preference的属性

<Preference
    app:key="feedback"
    app:summary="Report technical issues or suggest new features"
    app:title="Send feedback" />

 由于前面说过,Preference状态存储在SharedPreferences中,所以,每个Preference都必须有一个key,这样方便状态存储,如果当前key没有设置,在后期的熟悉操作,可能会存在报错,如果报错key is null,设置一个key即可。

key:指定一个key

    java.lang.IllegalArgumentException: Key cannot be null

title:标题

summary:标题下方的内容

layout:可以嵌入一个layout,覆盖当前view的信息,title或者其他都不会显示,只显示layout

icon:左侧的图标

2.ListPreference

<ListPreference
    android:entries="@array/arry_entries"
    android:entryValues="@array/arry_values"
    app:key="ListPreference"
    app:summary="summary"
    app:title="ListPreference" />

entries:显示的item
entryValues:内部值

这两个是数组,核心是key和value对应关系,数据长度一致,否则会出问题

Preference preference = getPreferenceScreen().getPreference(0);
if (preference instanceof ListPreference) {

    ListPreference listPreference = (ListPreference) preference;
    String val = listPreference.getValue();
    listPreference.setOnPreferenceChangeListener(new Preference.OnPreferenceChangeListener() {
        @Override
        public boolean onPreferenceChange(Preference preference, Object newValue) {
            if (preference instanceof ListPreference) {
                //把preference这个preference强制转化为listpreference类型
                ListPreference listpreference = (ListPreference) preference;
                //获取listpreference中的实体内容
                CharSequence[] entries = listpreference.getEntries();
                CharSequence[] entVal = listpreference.getEntryValues();
                //获取listpreference中的实体内容的下标值
                int index = listpreference.findIndexOfValue((String) newValue);
                //把listpreference中的摘要显示为当前listpreference的实体内容中选择的那个项目
                listpreference.setSummary(entries[index] + "=" + entVal[index]);
            }
            return true;
        }
    });

点击获取对应的值

3.DropDownPreference:

下拉选择,和list的相似,但是list是弹窗。下拉的话会比较丑

 DropDownPreference的配置和ListPreference一样,只是,ListPreference是dialog的弹窗展示,DropDownPreference的是一个recycleview的adapter,都是继承DialogPreference。

 这个显示可以自己定义。

内部Adapter数据添加:

3.CheckBoxPreference

CheckBox是勾选,多了一个开和关的状态

<CheckBoxPreference
    app:key="CheckBoxPreference"
    app:title="CheckBoxPreference"
    app:summary="CheckBoxPreference"
    app:summaryOff="summaryOff"
    app:summaryOn="summaryOn"
    />

 app:summaryOn的优先级大于app:summary,如果设置了on和off的summary,原来的summary将被覆盖了

4.SwitchPreference

开关,和原来Switch的控件一样使用,

<SwitchPreference
    app:title="SwitchPreference"
    app:summary="summary"
    app:summaryOff="summaryOff"
    app:summaryOn="summaryOn"
    />

用法和CheckBox一样。

5.EditTextPreference

 是edittext的状态,

 

<EditTextPreference
    app:key="edit"
    app:summary="summary"
    app:title="EditTextPreference"

    />

如果未指定key,将会报错

点击edittextPreference,将会弹窗一个输入框,dialog的弹窗就是我们的edittext内容。

6.MultiSelectListPreference

 多选。用法和list以及DropDownPreference一样。

需要配置数据来源

<MultiSelectListPreference
    app:key="multiselect"
    app:title="MultiSelectListPreference"
    app:summary="summary"
    android:entries="@array/arry_entries"
    android:entryValues="@array/arry_values"
    />

7.PreferenceCategory

分类。目前和Preference用法差不多。也是不可用。

@Override
public boolean isEnabled() {
    return false;
}

8.PreferenceScreen

是一个根节点。

 9.SeekBarPreference

seekbar是原来Android的滑动控件。Preference拼接以后,变成一个可以存储的。

<SeekBarPreference
    app:key="seek"
    app:summary="SeekBarPreference"
    app:title="SeekBarPreference"
    android:max="100"

    />

为什么会存在SharePreference?为什么这些控件都是已Preference结尾?现在大家应该明白了吧。

同理,如果缓存被清了,这些状态也会被清掉。

二.引用

1.继承:PreferenceFragmentCompat

public class MySettingsFragment extends PreferenceFragmentCompat

我们需要继承PreferenceFragmentCompat模块,重写

public void onCreatePreferences(Bundle savedInstanceState, String rootKey) 的方法。

加载xml文件:

setPreferencesFromResource(R.xml.preferences, rootKey);

获取节点信息:

getPreferenceManager():获取到一个Manager对象,或者直接获取getPreferenceScreen().

如果想获取SharedPreferences信息,可以通过PreferenceManager;

getPreferenceManager().getSharedPreferences();
getPreferenceManager().getSharedPreferencesName();
getPreferenceManager().getSharedPreferencesMode()
PreferenceScreen:

获取childCount=getPreferenceCount()

获取指定preference= getPreferenceScreen().getPreference(int position);

然后可以对Preference进行二次编辑

 

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/你好赵伟/article/detail/153004
推荐阅读
相关标签
  

闽ICP备14008679号