PreferenceFragment

要从XML中膨胀，请使用addPreferencesFromResource(int) 。 根元素应该是PreferenceScreen 。 后续元素可以指向实际的Preference子类。 如上所述，层次结构中的后续PreferenceScreen将导致屏幕中断。

要指定以 PreferenceScreen根的对象层次结构，请使用 setPreferenceScreen(PreferenceScreen) 。

为方便起见，此片段为当前层次结构中的任何首选项实现点击侦听器，请参阅 onPreferenceTreeClick(Preference) 。

Sample Code

以下示例代码显示了从资源填充的简单首选项片段。 它加载的资源是：

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

    <PreferenceCategory
            android:title="@string/inline_preferences">

        <CheckBoxPreference
                android:key="checkbox_preference"
                android:title="@string/title_checkbox_preference"
                android:summary="@string/summary_checkbox_preference" />

    </PreferenceCategory>

    <PreferenceCategory
            android:title="@string/dialog_based_preferences">

        <EditTextPreference
                android:key="edittext_preference"
                android:title="@string/title_edittext_preference"
                android:summary="@string/summary_edittext_preference"
                android:dialogTitle="@string/dialog_title_edittext_preference" />

        <ListPreference
                android:key="list_preference"
                android:title="@string/title_list_preference"
                android:summary="@string/summary_list_preference"
                android:entries="@array/entries_list_preference"
                android:entryValues="@array/entryvalues_list_preference"
                android:dialogTitle="@string/dialog_title_list_preference" />

    </PreferenceCategory>

    <PreferenceCategory
            android:title="@string/launch_preferences">

        <!-- This PreferenceScreen tag serves as a screen break (similar to page break
             in word processing). Like for other preference types, we assign a key
             here so it is able to save and restore its instance state. -->
        <PreferenceScreen
                android:key="screen_preference"
                android:title="@string/title_screen_preference"
                android:summary="@string/summary_screen_preference">

            <!-- You can place more preferences here that will be shown on the next screen. -->

            <CheckBoxPreference
                    android:key="next_screen_checkbox_preference"
                    android:title="@string/title_next_screen_toggle_preference"
                    android:summary="@string/summary_next_screen_toggle_preference" />

        </PreferenceScreen>

        <PreferenceScreen
                android:title="@string/title_intent_preference"
                android:summary="@string/summary_intent_preference">

            <intent android:action="android.intent.action.VIEW"
                    android:data="http://www.android.com" />

        </PreferenceScreen>

    </PreferenceCategory>

    <PreferenceCategory
            android:title="@string/preference_attributes">

        <CheckBoxPreference
                android:key="parent_checkbox_preference"
                android:title="@string/title_parent_preference"
                android:summary="@string/summary_parent_preference" />

        <!-- The visual style of a child is defined by this styled theme attribute. -->
        <CheckBoxPreference
                android:key="child_checkbox_preference"
                android:dependency="parent_checkbox_preference"
                android:layout="?android:attr/preferenceLayoutChild"
                android:title="@string/title_child_preference"
                android:summary="@string/summary_child_preference" />

    </PreferenceCategory>

</PreferenceScreen>

片段实现本身只是在创建时填充首选项。 请注意，首选项框架负责将当前值从应用程序首选项中加载出来，并在更改时写入它们：

public static class PrefsFragment extends PreferenceFragment {

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

        // Load the preferences from an XML resource
        addPreferencesFromResource(R.xml.preferences);
    }
}

Summary

Inherited XML attributes

From class android.app.Fragment android:fragmentAllowEnterTransitionOverlap Sets whether the enter and exit transitions should overlap when transitioning forward.  android:fragmentAllowReturnTransitionOverlap Sets whether the enter and exit transitions should overlap when transitioning because of popping the back stack.  android:fragmentEnterTransition The Transition that will be used to move Views into the initial scene.  android:fragmentExitTransition The Transition that will be used to move Views out of the scene when the fragment is removed, hidden, or detached when not popping the back stack.  android:fragmentReenterTransition The Transition that will be used to move Views in to the scene when returning due to popping a back stack.  android:fragmentSharedElementEnterTransition The Transition that will be used for shared elements transferred into the content Scene.  android:fragmentSharedElementReturnTransition The Transition that will be used for shared elements transferred back during a pop of the back stack.

Inherited constants

From interface android.content.ComponentCallbacks2 int TRIM_MEMORY_BACKGROUND 级别为 onTrimMemory(int) ：进程已经进入LRU列表。 int TRIM_MEMORY_COMPLETE 级别为 onTrimMemory(int) ：进程接近后台LRU列表的末尾，如果没有找到更多内存，它将被终止。 int TRIM_MEMORY_MODERATE 级别为onTrimMemory(int) ：进程位于后台LRU列表的中间; 释放内存可以帮助系统保留列表中稍后运行的其他进程，以获得更好的整体性能。 int TRIM_MEMORY_RUNNING_CRITICAL 级别为 onTrimMemory(int) ：该进程不是一个 onTrimMemory(int)后台进程，但该设备运行内存极低，并且将不能保持任何后台进程的运行。 int TRIM_MEMORY_RUNNING_LOW onTrimMemory(int)等级：该过程不是可消耗的后台过程，但设备内存不足。 int TRIM_MEMORY_RUNNING_MODERATE onTrimMemory(int)等级：该过程不是可消耗的后台过程，但该设备的内存运行状况偏低。 int TRIM_MEMORY_UI_HIDDEN onTrimMemory(int)等级：该过程已显示用户界面，并且不再这样做。

Inherited methods
From class android.app.Fragment void dump(String prefix, FileDescriptor fd, PrintWriter writer, String[] args) 将片段的状态打印到给定的流中。 final boolean equals(Object o) 子类不能覆盖equals（）。 final Activity getActivity() 返回此片段当前与之关联的活动。 boolean getAllowEnterTransitionOverlap() 返回退出转换和输入转换是否重叠。 boolean getAllowReturnTransitionOverlap() 返回返回转换和重新输入转换是否重叠。 final Bundle getArguments() 返回提供给 setArguments(Bundle)的参数，如果有的话。 final FragmentManager getChildFragmentManager() 返回一个专用的FragmentManager，用于放置和管理这个Fragment中的碎片。 Context getContext() 返回此片段当前与之关联的 Context 。 Transition getEnterTransition() 返回将用于将Views移动到初始场景的Transition。 Transition getExitTransition() 当不弹出背堆栈时，返回将用于将视图移出场景的过渡，当片段被移除，隐藏或分离时。 final FragmentManager getFragmentManager() 返回FragmentManager以与与该片段活动关联的片段进行交互。 final Object getHost() 返回这个片段的主机对象。 final int getId() 返回此片段已知的标识符。 LoaderManager getLoaderManager() 为这个片段返回LoaderManager，如果需要的话创建它。 final Fragment getParentFragment() 返回包含此片段的父片段。 Transition getReenterTransition() 返回由于弹出背堆栈而返回的视图，以便将视图移动到场景中。 final Resources getResources() 返回 getActivity().getResources() 。 final boolean getRetainInstance() Transition getReturnTransition() 当片段准备由于弹出背堆栈而被移除，隐藏或分离时，返回将用于将视图移出场景的Transition。 Transition getSharedElementEnterTransition() 返回将用于传输到内容场景中的共享元素的转换。 Transition getSharedElementReturnTransition() 返回将在返回堆栈弹出期间传回的共享元素的转换。 final String getString(int resId, Object... formatArgs) 从应用程序包的默认字符串表中返回一个本地化的格式化字符串，替换 Formatter和 format(String, Object...)定义的格式参数。 final String getString(int resId) 从应用程序包的默认字符串表中返回一个本地化的字符串。 final String getTag() 获取片段的标签名称（如果指定）。 final Fragment getTargetFragment() 返回由 setTargetFragment(Fragment, int)设置的目标片段。 final int getTargetRequestCode() 返回 setTargetFragment(Fragment, int)设置的目标请求代码。 final CharSequence getText(int resId) 从应用程序包的默认字符串表中返回一个本地化的，风格化的CharSequence。 boolean getUserVisibleHint() View getView() 获取片段布局的根视图（由 onCreateView(LayoutInflater, ViewGroup, Bundle)返回），如果提供。 final int hashCode() 子类不能重写hashCode（）。 static Fragment instantiate(Context context, String fname) 像 instantiate(Context, String, Bundle)一样，但是有一个空参数Bundle。 static Fragment instantiate(Context context, String fname, Bundle args) 用给定的类名创建一个Fragment的新实例。 final boolean isAdded() 如果片段当前被添加到其活动中，则返回true。 final boolean isDetached() 如果片段已从UI中明确分离，则返回true。 final boolean isHidden() 如果片段已隐藏，则返回true。 final boolean isInLayout() 如果通过<fragment>标签将布局作为活动视图层次结构的一部分包含在内，则返回true。 final boolean isRemoving() 如果此片段当前正从其活动中移除，则返回true。 final boolean isResumed() 如果片段处于恢复状态，则返回true。 final boolean isVisible() 如果片段当前对用户可见，则返回true。 void onActivityCreated(Bundle savedInstanceState) 当片段的活动已经创建并且该片段的视图层次被实例化时调用。 void onActivityResult(int requestCode, int resultCode, Intent data) 接收先前调用 startActivityForResult(Intent, int)的结果。 void onAttach(Activity activity) 此方法在API级别23中已弃用。请改用onAttach(Context) 。 void onAttach(Context context) 当片段首次附加到其上下文时调用。 void onAttachFragment(Fragment childFragment) 当片段附加为此片段的子元素时调用。 void onConfigurationChanged(Configuration newConfig) 设备配置在组件运行时发生更改时由系统调用。 boolean onContextItemSelected(MenuItem item) 只要选择了上下文菜单中的项目，就会调用该钩子。 void onCreate(Bundle savedInstanceState) 被调用来做一个片段的初始创建。 Animator onCreateAnimator(int transit, boolean enter, int nextAnim) 当片段加载动画时调用。 void onCreateContextMenu(ContextMenu menu, View v, ContextMenu.ContextMenuInfo menuInfo) 当即将显示 view的上下文菜单时调用。 void onCreateOptionsMenu(Menu menu, MenuInflater inflater) 初始化活动标准选项菜单的内容。 View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) 调用以使片段实例化其用户界面视图。 void onDestroy() 当碎片不再使用时调用。 void onDestroyOptionsMenu() 当此片段的选项菜单项不再包含在总体选项菜单中时调用。 void onDestroyView() 当以前由 onCreateView(LayoutInflater, ViewGroup, Bundle)创建的视图已从片段中分离时调用。 void onDetach() 当片段不再附加到其活动时调用。 void onHiddenChanged(boolean hidden) 当隐藏状态（由片段的 isHidden()返回时已更改）调用。 void onInflate(AttributeSet attrs, Bundle savedInstanceState) 此方法在API级别12中已弃用。请改用onInflate(Context, AttributeSet, Bundle) 。 void onInflate(Activity activity, AttributeSet attrs, Bundle savedInstanceState) 此方法在API级别23中已弃用。请改用onInflate(Context, AttributeSet, Bundle) 。 void onInflate(Context context, AttributeSet attrs, Bundle savedInstanceState) 当片段被创建为视图布局膨胀的一部分时调用，通常通过设置活动的内容视图来调用。 void onLowMemory() 这在整个系统内存不足时调用，并且主动运行的进程应该修剪内存使用情况。 void onMultiWindowModeChanged(boolean isInMultiWindowMode) 当片段的活动从全屏模式更改为多窗口模式时调用，反之亦然。 boolean onOptionsItemSelected(MenuItem item) 只要选择了选项菜单中的项目，就会调用该钩子。 void onOptionsMenuClosed(Menu menu) 只要选项菜单被关闭（通过用户使用后退/菜单按钮取消菜单，或选择某个项目时），就会调用该钩子。 void onPause() 当碎片不再恢复时调用。 void onPictureInPictureModeChanged(boolean isInPictureInPictureMode) 当活动从画中画模式切换到画中画模式时由系统调用。 void onPrepareOptionsMenu(Menu menu) 准备显示屏幕的标准选项菜单。 void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) 从请求权限回调结果。 void onResume() 当片段对用户可见且正在积极运行时调用。 void onSaveInstanceState(Bundle outState) 打电话询问片段以保存其当前的动态状态，以便稍后可以在重新启动其进程的新实例时重新构建它。 void onStart() 当片段对用户可见时调用。 void onStop() 当片段不再启动时调用。 void onTrimMemory(int level) 当操作系统确定进程从其进程中删除不需要的内存是一个好时机时调用。 void onViewCreated(View view, Bundle savedInstanceState) 在 onCreateView(LayoutInflater, ViewGroup, Bundle)已经返回之后立即调用，但在任何已保存的状态恢复到视图之前。 void onViewStateRestored(Bundle savedInstanceState) 当所有保存的状态已恢复到片段的视图层次结构中时调用。 void registerForContextMenu(View view) 为给定视图注册一个上下文菜单（多个视图可以显示上下文菜单）。 final void requestPermissions(String[] permissions, int requestCode) 请求授予此应用程序的权限。 void setAllowEnterTransitionOverlap(boolean allow) 设置退出转换和输入转换是否重叠。 void setAllowReturnTransitionOverlap(boolean allow) 设置返回转换和重新输入转换是否重叠。 void setArguments(Bundle args) 为此片段提供构造参数。 void setEnterSharedElementCallback(SharedElementCallback callback) 当使用Fragments使用自定义转换时，当此片段在未弹出返回堆栈时连接或分离时，会调用enter转换回调。 void setEnterTransition(Transition transition) 设置将用于将Views移动到初始场景的Transition。 void setExitSharedElementCallback(SharedElementCallback callback) 当自定义转换与碎片一起使用时，退出转换回调在弹出回栈时附加或分离时调用。 void setExitTransition(Transition transition) 设置当片段被移除，隐藏或在未弹出背堆栈时分离时将用于将视图移出场景的Transition。 void setHasOptionsMenu(boolean hasMenu) 报告此片段希望通过接收对 onCreateOptionsMenu(Menu, MenuInflater)和相关方法的调用来参与填充选项菜单。 void setInitialSavedState(Fragment.SavedState state) 设置该片段应该从第一次构建时恢复的初始保存状态，由 FragmentManager.saveFragmentInstanceState返回。 void setMenuVisibility(boolean menuVisible) 设置该片段的菜单是否可见。 void setReenterTransition(Transition transition) 设置用于在由于弹出背堆栈而返回时将Views移动到场景中的Transition。 void setRetainInstance(boolean retain) 控制是否在重新创建Activity时（例如从配置更改）保留片段实例。 void setReturnTransition(Transition transition) 设置当片段准备由于弹出背堆栈而被移除，隐藏或分离时将用于将视图移出场景的Transition。 void setSharedElementEnterTransition(Transition transition) 设置将用于共享元素转移到内容场景的转换。 void setSharedElementReturnTransition(Transition transition) 设置将在回弹堆栈弹出期间回传的共享元素的转换。 void setTargetFragment(Fragment fragment, int requestCode) 此片段的可选目标。 void setUserVisibleHint(boolean isVisibleToUser) 为系统提供一个关于此片段的用户界面当前是否可见的提示。 boolean shouldShowRequestPermissionRationale(String permission) 获取是否应该以请求许可的理由显示UI。 void startActivity(Intent intent) 从片段的Activity中调用 startActivity(Intent) 。 void startActivity(Intent intent, Bundle options) 从片段的Activity中调用 startActivity(Intent, Bundle) 。 void startActivityForResult(Intent intent, int requestCode) 从片段的Activity中调用 startActivityForResult(Intent, int) 。 void startActivityForResult(Intent intent, int requestCode, Bundle options) 从片段的Activity中调用 startActivityForResult(Intent, int, Bundle) 。 void startIntentSenderForResult(IntentSender intent, int requestCode, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options) 从片段的Activity中调用 startIntentSenderForResult(IntentSender, int, Intent, int, int, int, Bundle) 。 String toString() 返回对象的字符串表示形式。 void unregisterForContextMenu(View view) 防止为给定视图显示上下文菜单。
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为此对象调用 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程，或者经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。
From interface android.content.ComponentCallbacks2 abstract void onTrimMemory(int level) 当操作系统确定进程从其进程中删除不需要的内存是一个好时机时调用。
From interface android.view.View.OnCreateContextMenuListener abstract void onCreateContextMenu(ContextMenu menu, View v, ContextMenu.ContextMenuInfo menuInfo) 在构建此视图的上下文菜单时调用。
From interface android.support.v7.preference.PreferenceManager.OnPreferenceTreeClickListener abstract boolean onPreferenceTreeClick(Preference preference) 当根据此 PreferenceScreen的树中的偏好已被点击时调用。
From interface android.support.v7.preference.PreferenceManager.OnDisplayPreferenceDialogListener abstract void onDisplayPreferenceDialog(Preference preference) 当树中的首选项请求显示对话框时调用。
From interface android.support.v7.preference.PreferenceManager.OnNavigateToScreenListener abstract void onNavigateToScreen(PreferenceScreen preferenceScreen) 当树中的PreferenceScreen请求导航到其内容时调用。
From interface android.support.v7.preference.DialogPreference.TargetFragment abstract Preference findPreference(CharSequence key)
From interface android.content.ComponentCallbacks abstract void onConfigurationChanged(Configuration newConfig) 设备配置在组件运行时发生更改时由系统调用。 abstract void onLowMemory() 这在整个系统内存不足时调用，并且主动运行的进程应该修剪内存使用情况。

XML attributes

android:divider

列出分隔符以在偏好视图之间绘制

可能是另一种资源的引用，其形式为“ @[+][package:]type/name ”或形式为“一个主题属性 ?[package:]type/name ”。

可以是“ #rgb ”，“ #argb ”，“ #rrggbb#aarrggbb ”形式的颜色值。

相关方法：

• setDivider(Drawable)

android:dividerHeight

列出分隔符高度

可能是一个维度值，这是一个浮点数，后面跟着一个单位，例如“ 14.5sp ”。 可用单位为：px（像素），dp（密度独立像素），sp（基于首选字体大小的缩放像素），单位为英寸和毫米。

相关方法：

• setDividerHeight(int)

Constants

String ARG_PREFERENCE_ROOT

Public constructors

PreferenceFragment ()

Public methods

void addPreferencesFromResource (int preferencesResId)

Preference findPreference (CharSequence key)

RecyclerView getListView ()

PreferenceManager getPreferenceManager ()

PreferenceScreen getPreferenceScreen ()

void onActivityCreated (Bundle savedInstanceState)

void onCreate (Bundle savedInstanceState)

RecyclerView.LayoutManager onCreateLayoutManager ()

void onCreatePreferences (Bundle savedInstanceState, 
                String rootKey)

RecyclerView onCreateRecyclerView (LayoutInflater inflater, 
                ViewGroup parent, 
                Bundle savedInstanceState)

View onCreateView (LayoutInflater inflater, 
                ViewGroup container, 
                Bundle savedInstanceState)

void onDestroyView ()

void onDisplayPreferenceDialog (Preference preference)

void onNavigateToScreen (PreferenceScreen preferenceScreen)

boolean onPreferenceTreeClick (Preference preference)

void onSaveInstanceState (Bundle outState)

void onStart ()

void onStop ()

void onViewCreated (View view, 
                Bundle savedInstanceState)

void scrollToPreference (Preference preference)

void scrollToPreference (String key)

void setDivider (Drawable divider)

void setDividerHeight (int height)

void setPreferenceScreen (PreferenceScreen preferenceScreen)

void setPreferencesFromResource (int preferencesResId, 
                String key)

Protected methods

Adapter onCreateAdapter (PreferenceScreen preferenceScreen)