DialogFragment

public class DialogFragment
extends Fragment implements DialogInterface.OnCancelListener, DialogInterface.OnDismissListener

Known Direct Subclasses PreferenceDialogFragment PreferenceDialogFragment 提供与 DialogPreference关联的对话框的抽象基类。

Known Indirect Subclasses EditTextPreferenceDialogFragment, ListPreferenceDialogFragment, MultiSelectListPreferenceDialogFragment EditTextPreferenceDialogFragment   ListPreferenceDialogFragment   MultiSelectListPreferenceDialogFragment

一个片段，显示一个对话窗口，在其活动窗口之上浮动。 这个片段包含一个Dialog对象，它根据片段的状态适当地显示它。 对话框的控制（决定何时显示，隐藏，解除）应通过此处的API完成，而不是直接调用对话框。

实现应覆盖此类并实现onCreateView(LayoutInflater, ViewGroup, Bundle)以提供对话的内容。 或者，他们可以覆盖onCreateDialog(Bundle)以创建具有自己内容的完全自定义对话框，例如AlertDialog。

涵盖的主题包括：

1. Lifecycle
2. Basic Dialog
3. Alert Dialog
4. Selecting Between Dialog or Embedding

Lifecycle

DialogFragment会执行各种操作来保持片段的生命周期，而不是Dialog。 请注意，对话框通常是自治实体 - 它们是它们自己的窗口，接收它们自己的输入事件，并经常决定何时消失（通过接收后退键事件或用户单击按钮）。

DialogFragment需要确保片段和对话状态发生的情况保持一致。 要做到这一点，它会监视对话中的退出事件，并在发生时删除自己的状态。 这意味着您应该使用show(FragmentManager, String)或show(FragmentTransaction, String)将show(FragmentTransaction, String)实例添加到您的UI中，因为这些实例将跟踪DialogFragment在关闭对话框时应如何移除。

Basic Dialog

DialogFragment最简单的用法是作为片段视图层次结构的浮动容器。 一个简单的实现可能如下所示：

public static class MyDialogFragment extends DialogFragment {
    int mNum;

    /**
     * Create a new instance of MyDialogFragment, providing "num"
     * as an argument.
     */
    static MyDialogFragment newInstance(int num) {
        MyDialogFragment f = new MyDialogFragment();

        // Supply num input as an argument.
        Bundle args = new Bundle();
        args.putInt("num", num);
        f.setArguments(args);

        return f;
    }

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mNum = getArguments().getInt("num");

        // Pick a style based on the num.
        int style = DialogFragment.STYLE_NORMAL, theme = 0;
        switch ((mNum-1)%6) {
            case 1: style = DialogFragment.STYLE_NO_TITLE; break;
            case 2: style = DialogFragment.STYLE_NO_FRAME; break;
            case 3: style = DialogFragment.STYLE_NO_INPUT; break;
            case 4: style = DialogFragment.STYLE_NORMAL; break;
            case 5: style = DialogFragment.STYLE_NORMAL; break;
            case 6: style = DialogFragment.STYLE_NO_TITLE; break;
            case 7: style = DialogFragment.STYLE_NO_FRAME; break;
            case 8: style = DialogFragment.STYLE_NORMAL; break;
        }
        switch ((mNum-1)%6) {
            case 4: theme = android.R.style.Theme_Holo; break;
            case 5: theme = android.R.style.Theme_Holo_Light_Dialog; break;
            case 6: theme = android.R.style.Theme_Holo_Light; break;
            case 7: theme = android.R.style.Theme_Holo_Light_Panel; break;
            case 8: theme = android.R.style.Theme_Holo_Light; break;
        }
        setStyle(style, theme);
    }

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
            Bundle savedInstanceState) {
        View v = inflater.inflate(R.layout.fragment_dialog, container, false);
        View tv = v.findViewById(R.id.text);
        ((TextView)tv).setText("Dialog #" + mNum + ": using style "
                + getNameForNum(mNum));

        // Watch for button clicks.
        Button button = (Button)v.findViewById(R.id.show);
        button.setOnClickListener(new OnClickListener() {
            public void onClick(View v) {
                // When button is clicked, call up to owning activity.
                ((FragmentDialog)getActivity()).showDialog();
            }
        });

        return v;
    }
}

Activity上的showDialog（）方法示例可以是：

void showDialog() {
    mStackLevel++;

    // DialogFragment.show() will take care of adding the fragment
    // in a transaction.  We also want to remove any currently showing
    // dialog, so make our own transaction and take care of that here.
    FragmentTransaction ft = getFragmentManager().beginTransaction();
    Fragment prev = getFragmentManager().findFragmentByTag("dialog");
    if (prev != null) {
        ft.remove(prev);
    }
    ft.addToBackStack(null);

    // Create and show the dialog.
    DialogFragment newFragment = MyDialogFragment.newInstance(mStackLevel);
    newFragment.show(ft, "dialog");
}

这将删除当前显示的任何对话框，使用参数创建一个新的DialogFragment，并将其显示为反向堆栈中的新状态。 当事务被弹出时，当前的DialogFragment及其对话框将被销毁，并且前一个（如果有的话）被重新显示。 请注意，在这种情况下，DialogFragment会照顾弹出对话框的事务被单独解除。

Alert Dialog

除了实现 onCreateView(LayoutInflater, ViewGroup, Bundle)以在对话框内生成视图层次结构之外（或除此之外），您可以实现 onCreateDialog(Bundle)以创建自己的自定义对话框对象。

这对于创建AlertDialog最为有用，它允许您向用户显示由片段管理的标准警报。 一个简单的例子是：

public static class MyAlertDialogFragment extends DialogFragment {

    public static MyAlertDialogFragment newInstance(int title) {
        MyAlertDialogFragment frag = new MyAlertDialogFragment();
        Bundle args = new Bundle();
        args.putInt("title", title);
        frag.setArguments(args);
        return frag;
    }

    @Override
    public Dialog onCreateDialog(Bundle savedInstanceState) {
        int title = getArguments().getInt("title");

        return new AlertDialog.Builder(getActivity())
                .setIcon(R.drawable.alert_dialog_icon)
                .setTitle(title)
                .setPositiveButton(R.string.alert_dialog_ok,
                    new DialogInterface.OnClickListener() {
                        public void onClick(DialogInterface dialog, int whichButton) {
                            ((FragmentAlertDialog)getActivity()).doPositiveClick();
                        }
                    }
                )
                .setNegativeButton(R.string.alert_dialog_cancel,
                    new DialogInterface.OnClickListener() {
                        public void onClick(DialogInterface dialog, int whichButton) {
                            ((FragmentAlertDialog)getActivity()).doNegativeClick();
                        }
                    }
                )
                .create();
    }
}

创建此片段的活动可能具有以下方法来显示对话框并从中接收结果：

void showDialog() {
    DialogFragment newFragment = MyAlertDialogFragment.newInstance(
            R.string.alert_dialog_two_buttons_title);
    newFragment.show(getFragmentManager(), "dialog");
}

public void doPositiveClick() {
    // Do stuff here.
    Log.i("FragmentAlertDialog", "Positive click!");
}

public void doNegativeClick() {
    // Do stuff here.
    Log.i("FragmentAlertDialog", "Negative click!");
}

请注意，在这种情况下，片段不会放置在背堆栈上，它只会作为无限期运行的片段添加。 由于对话框通常是模态的，因此对话框将捕获用户输入，直到它被解散为止，它仍将作为后退堆栈运行。 当它被解雇时，DialogFragment将负责从自己的片段管理器中删除自己。

Selecting Between Dialog or Embedding

如果需要，DialogFragment仍可以选择用作普通片段。 如果你有一个片段，在某些情况下应该显示为对话框，而其他片段嵌入到更大的UI中，这非常有用。 此行为通常会根据您如何使用片段自动为您选择，但可以使用setShowsDialog(boolean)进行自定义。

例如，下面是一个简单的对话框片段：

public static class MyDialogFragment extends DialogFragment {
    static MyDialogFragment newInstance() {
        return new MyDialogFragment();
    }

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
            Bundle savedInstanceState) {
        View v = inflater.inflate(R.layout.hello_world, container, false);
        View tv = v.findViewById(R.id.text);
        ((TextView)tv).setText("This is an instance of MyDialogFragment");
        return v;
    }
}

这个片段的一个实例可以创建并显示为一个对话框：

void showDialog() {
    // Create the fragment and show it as a dialog.
    DialogFragment newFragment = MyDialogFragment.newInstance();
    newFragment.show(getFragmentManager(), "dialog");
}

它也可以添加为视图层次结构中的内容：

FragmentTransaction ft = getFragmentManager().beginTransaction();
DialogFragment newFragment = MyDialogFragment.newInstance();
ft.add(R.id.embedded, newFragment);
ft.commit();

摘要(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) ：这个过程不是一个消耗性的后台进程，但是该设备运行内存非常低，并且将不能保持任何后台进程运行。 int TRIM_MEMORY_RUNNING_LOW 级别为 onTrimMemory(int) ：该过程不是一个 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.content.DialogInterface.OnCancelListener abstract void onCancel(DialogInterface dialog) 这个方法将在对话框被取消时被调用。
From interface android.content.DialogInterface.OnDismissListener abstract void onDismiss(DialogInterface dialog) 该方法将在对话框关闭时调用。
From interface android.content.ComponentCallbacks abstract void onConfigurationChanged(Configuration newConfig) 设备配置在组件运行时发生更改时由系统调用。 abstract void onLowMemory() 这在整个系统内存不足时调用，并且主动运行的进程应该修剪内存使用情况。

常量(Constants)

int STYLE_NORMAL

int STYLE_NO_FRAME

int STYLE_NO_INPUT

int STYLE_NO_TITLE

Public constructors

DialogFragment ()

公共方法(Public methods)

void dismiss ()

void dismissAllowingStateLoss ()

void dump (String prefix, 
                FileDescriptor fd, 
                PrintWriter writer, 
                String[] args)

Dialog getDialog ()

boolean getShowsDialog ()

int getTheme ()

boolean isCancelable ()

void onActivityCreated (Bundle savedInstanceState)

void onAttach (Context context)

void onCancel (DialogInterface dialog)

void onCreate (Bundle savedInstanceState)

Dialog onCreateDialog (Bundle savedInstanceState)

void onDestroyView ()

void onDetach ()

void onDismiss (DialogInterface dialog)

void onSaveInstanceState (Bundle outState)

void onStart ()

void onStop ()

void setCancelable (boolean cancelable)

void setShowsDialog (boolean showsDialog)

void setStyle (int style, 
                int theme)

void show (FragmentManager manager, 
                String tag)

int show (FragmentTransaction transaction, 
                String tag)