Android开发之PreferenceActivity的使用

最新推荐文章于 2019-06-11 23:37:11 发布

沐雨花飞蝶

最新推荐文章于 2019-06-11 23:37:11 发布

阅读量1.5k

点赞数

分类专栏： Android

本文链接：https://blog.csdn.net/qq_35805528/article/details/78800637

版权

Android 专栏收录该内容

23 篇文章 0 订阅

订阅专栏

PreferenceActivity

在开发应用程序时，有时我们会有选项设置界面，通常我们可以使用SharePreference以键值对的形式进行保存。Android为我们提供了PreferenceActivity。PreferencesActivity是Android中专门用来实现程序设置界面及参数存储的一个Activity。
我们只要把Activity继承PreferenceActivity， PreferenceActivity会帮我们处理选项的读写。从Android3.0开始，官方不推荐单独使用PreferenceActivity，而是建议PreferenceActivity与PreferenceFragment结合使用。

PreferenceActivity结合PreferenceFragment实现选项设置

官方建议PreferenceActivity与PreferenceFragment结合使用，其中PreferenceActivity负责加载选项配置列表的布局文件，PreferenceFragment负责加载选项配置的布局文件。

在res下创建xml目录来创建布局

例如：
PreferenceActivity加载的布局如下，不是layout，而是preference-headers。

res/xml/pref_headers.xml

<preference-headers xmlns:android="http://schemas.android.com/apk/res/android">
    <!--启动指定PreferenceFragment-->
    <header
        android:fragment="com.rair.preferenceactivitydemo.PreferenceActivityWithPreferenceFragment$GeneralPreferenceFragment"
        android:icon="@drawable/ic_info_black_24dp"
        android:title="@string/pref_header_general" />

</preference-headers>

我们可以通过android:fragment来指定启动PreferenceFragment，当然了，也可以通过Intent来启动指定Activity。

<header
        android:icon="@drawable/ic_info_black_24dp"
        android:title="@string/pref_header_general">
        <intent
            android:action="android.intent.action.VIEW"
            android:data="https://www.baidu.com" />
    </header>

Activity:

public class PreferenceActivityWithPreferenceFragment extends AppCompatPreferenceActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
    }


    @Override
    @TargetApi(Build.VERSION_CODES.HONEYCOMB)
    public void onBuildHeaders(List<Header> target) {
        //加载选项列表布局
        loadHeadersFromResource(R.xml.pref_headers, target);
    }

    /**
     * 验证Preference是否有效
     *
     * @param fragmentName
     * @return
     */
    protected boolean isValidFragment(String fragmentName) {
        return true;
    }

    /**
     * GeneralPreferenceFragment
     */
    @TargetApi(Build.VERSION_CODES.HONEYCOMB)
    public static class GeneralPreferenceFragment extends PreferenceFragment {
        @Override
        public void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            addPreferencesFromResource(R.xml.pref_general);
        }
    }

}

PreferenceActivity负责加载选项配置列表的布局文件
preference-headers根标签相当于一个列表，header标签相当于每个Item。

如下：

PreferenceFragment负责加载选项配置的布局文件
res/xml/pref_general.xml

<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">

    <EditTextPreference
        android:capitalize="words"
        android:defaultValue="@string/pref_default_display_name"
        android:inputType="textCapWords"
        android:key="example_text"
        android:maxLines="1"
        android:selectAllOnFocus="true"
        android:singleLine="true"
        android:title="@string/pref_title_display_name" />
    <Preference
        android:summary="么么哒"
        android:title="Rair" />
</PreferenceScreen>

如下：

完成效果如下：

我们来看看提供了哪几种布局元素可供使用

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

2.EditTextPreference:输入编辑框，值为String类型，会弹出对话框供输入。
3.ListPreference: 列表选择，弹出对话框供选择。
4.Preference：只进行文本显示，需要与其他进行组合使用。
5.PreferenceCategory：用于分组。效果如下:

6.PreferenceScreen:PreferenceActivity的根元素。
7.RingtonePreference：系统铃声选择。
8.MultiSelectListPreference：列表选择（多选）
9.SwitchPreference：Switch

接着上面，PreferenceFragment布局修改如下：
res/xml/pref_general.xml布局

<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">
    <PreferenceCategory android:title="第一组">
        <CheckBoxPreference
            android:checked="true"
            android:title="不再提醒" />
    </PreferenceCategory>
    <PreferenceCategory android:title="第二组">
        <EditTextPreference
            android:capitalize="words"
            android:defaultValue="@string/pref_default_display_name"
            android:inputType="textCapWords"
            android:key="example_text"
            android:maxLines="1"
            android:selectAllOnFocus="true"
            android:singleLine="true"
            android:title="@string/pref_title_display_name" />
        <ListPreference
            android:dialogTitle="城市"
            android:entries="@array/city"
            android:entryValues="@array/country"
            android:title="列表" />
        <Preference
            android:summary="么么哒"
            android:title="Rair" />
        <SwitchPreference android:title="免打扰" />
    </PreferenceCategory>
</PreferenceScreen>

android:entries="@array/city"
android:entryValues="@array/country"

<string-array name="city">
        <item>北京</item>
        <item>上海</item>
        <item>广州</item>
        <item>深圳</item>
    </string-array>
    <string-array name="country">
        <item>A</item>
        <item>B</item>
        <item>C</item>
        <item>D</item>
    </string-array>

效果如图：

PreferenceCategory属性：

key：唯一标识（至少在同一程序中是唯一），SharedPreferences也将通过此Key值进行数据保存,也可以通过key值获取保存的信息。
title：显示标题（大字体显示）
summary:副标题（小字体显示）
defaultValue:默认值
dependency：附属，即标识此元素附属于某一个元素（通常为CheckBoxPreference)，dependency值为所附属元素的key。当CheckPreference值为true时，Preference则为可用，否则为不可用。
dialogTitle：弹出对话框的标题
entries：列表中显示的值。为一个数组，通常通过资源文件进行设置。
entryValues：列表中实际保存的值，与entries对应。（上面的city和county）

写个例子

例子直接用的Activity结合PreferenceFragment实现
我们用PreferenceScreen来实现下图布局

res/xml/pref_my.xml布局

<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">
    <Preference
        android:key="one"
        android:summary="配置全局应用设置"
        android:title="应用" />
    <Preference
        android:key="two"
        android:summary="配置编辑器"
        android:title="编辑器" />
    <Preference
        android:key="three"
        android:summary="配置全局应用设置"
        android:title="应用" />
    <Preference
        android:key="four"
        android:summary="配置代码风格"
        android:title="代码风格" />
    <Preference
        android:key="five"
        android:summary="配置构建运行设置"
        android:title="构建运行" />
    <Preference
        android:key="six"
        android:summary="配置Dropbox同步设置"
        android:title="Dropbox" />
    <Preference
        android:key="seven"
        android:summary="配置Git版本控制"
        android:title="Git版本控制" />
    <Preference
        android:key="eight"
        android:summary="显示法律相关信息"
        android:title="法律" />
</PreferenceScreen>

MyFragment:

public class MyFragment extends PreferenceFragment {
    @Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        getPreferenceManager().setSharedPreferencesMode(MODE_WORLD_READABLE);
        addPreferencesFromResource(R.xml.pref_my);
    }

    @Override
    public void onViewCreated(View view, @Nullable Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);

        Preference one = findPreference("one");
        one.setOnPreferenceClickListener(new Preference.OnPreferenceClickListener() {
            @Override
            public boolean onPreferenceClick(Preference preference) {
                Toast.makeText(getActivity(), "one", Toast.LENGTH_SHORT).show();
                return true;
            }
        });

        findPreference("two").setOnPreferenceClickListener(new Preference.OnPreferenceClickListener() {
            @Override
            public boolean onPreferenceClick(Preference preference) {
                Toast.makeText(getActivity(), "two", Toast.LENGTH_SHORT).show();
                return true;
            }
        });
        findPreference("three").setOnPreferenceClickListener(new Preference.OnPreferenceClickListener() {
            @Override
            public boolean onPreferenceClick(Preference preference) {
                Toast.makeText(getActivity(), "再点一下试试", Toast.LENGTH_SHORT).show();
                return true;
            }
        });
        findPreference("four").setOnPreferenceClickListener(new Preference.OnPreferenceClickListener() {
            @Override
            public boolean onPreferenceClick(Preference preference) {
                Toast.makeText(getActivity(), "试试就试试", Toast.LENGTH_SHORT).show();
                return true;
            }
        });
    }
}

Activity:

public class ActivityWithPreferenceFragment extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_with_preference_fragment);

        FragmentTransaction fragmentTransaction = getFragmentManager().beginTransaction();
        fragmentTransaction.replace(R.id.fl, new MyFragment()).commit();
    }
}

开篇有说到Preference以键值对的形式进行保存，所以我给每一项设置了一个key。这个的作用和我们常用的id差不多，一会如果我们要引用这个组件可以通过key来找到他。

我们来加几个点击事件
OnPreferenceClickListener 用来监听某个选项是否被点击

public class MyFragment extends PreferenceFragment {
    @Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        getPreferenceManager().setSharedPreferencesMode(MODE_WORLD_READABLE);
        addPreferencesFromResource(R.xml.pref_my);
    }

    @Override
    public void onViewCreated(View view, @Nullable Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);

        Preference one = findPreference("one");
        one.setOnPreferenceClickListener(new Preference.OnPreferenceClickListener() {
            @Override
            public boolean onPreferenceClick(Preference preference) {
                Toast.makeText(getActivity(), "one", Toast.LENGTH_SHORT).show();
                return true;
            }
        });

        findPreference("two").setOnPreferenceClickListener(new Preference.OnPreferenceClickListener() {
            @Override
            public boolean onPreferenceClick(Preference preference) {
                Toast.makeText(getActivity(), "two", Toast.LENGTH_SHORT).show();
                return true;
            }
        });
        findPreference("three").setOnPreferenceClickListener(new Preference.OnPreferenceClickListener() {
            @Override
            public boolean onPreferenceClick(Preference preference) {
                Toast.makeText(getActivity(), "再点一下试试", Toast.LENGTH_SHORT).show();
                return true;
            }
        });
        findPreference("four").setOnPreferenceClickListener(new Preference.OnPreferenceClickListener() {
            @Override
            public boolean onPreferenceClick(Preference preference) {
                Toast.makeText(getActivity(), "试试就试试", Toast.LENGTH_SHORT).show();
                return true;
            }
        });
    }
}

通过key找到对应组件
findPreference("two").setOnPreferenceClickListener(new Preference.OnPreferenceClickListener() {
@Override
public boolean onPreferenceClick(Preference preference) {
Toast.makeText(getActivity(), "two", Toast.LENGTH_SHORT).show();
return true;
}
});
运行一下：

程序的完整源代码
GitHub:https://github.com/Rairmmd/RairDemo/tree/master/PreferenceActivityDemo
Coding：https://git.coding.net/Rair/RairDemo.git

沐雨花飞蝶

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
Android开发之PreferenceActivity的使用

PreferenceActivity在开发应用程序时，有时我们会有选项设置界面，通常我们可以使用SharePreference以键值对的形式进行保存。Android为我们提供了PreferenceActivity。PreferencesActivity是Android中专门用来实现程序设置界面及参数存储的一个Activity。我们只要把Activity继承PreferenceActivity，
复制链接

扫一扫

专栏目录