Most visited

Recently visited

Results for

Added in API level 1
Summary: Inherited Constants | Ctors | Protected Ctors | Methods | Protected Methods | Inherited Methods | [Expand All]

Dialog

public class Dialog
extends Object implements DialogInterface, Window.Callback, KeyEvent.Callback, View.OnCreateContextMenuListener

java.lang.Object
   ↳ android.app.Dialog
Known Direct Subclasses
Known Indirect Subclasses

对话框的基类。

注：活动提供了一个设施来管理对话框的创建，保存和恢复。 见onCreateDialog(int) ， onPrepareDialog(int, Dialog) ， showDialog(int) ，并dismissDialog(int) 。 如果使用这些方法， getOwnerActivity()将返回管理此对话框的活动。

通常情况下，您需要在当前输入法的顶部显示对话框，因为没有理由接受文本。 您可以通过设置WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM窗口标志（假设您的对话框采用输入焦点，因为它是默认值）使用以下代码：

 getWindow().setFlags(WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM,
         WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM);

Developer Guides

有关创建对话框的更多信息，请阅读 Dialogs开发人员指南。

Summary

Inherited constants
From interface android.content.DialogInterface

Public constructors
Dialog(Context context)

创建一个使用默认对话框主题的对话窗口。
Dialog(Context context, int themeResId)

创建一个使用自定义对话框样式的对话窗口。

Protected constructors
Dialog(Context context, boolean cancelable, DialogInterface.OnCancelListener cancelListener)

Public methods
void addContentView(View view, ViewGroup.LayoutParams params)

在屏幕上添加一个额外的内容视图。
void cancel()

取消对话框。
void closeOptionsMenu()
void create()

强制立即创建对话框。
void dismiss()

关闭此对话框，将其从屏幕上移除。
boolean dispatchGenericMotionEvent(MotionEvent ev)

被调用来处理通用运动事件。
boolean dispatchKeyEvent(KeyEvent event)

被调用来处理关键事件。
boolean dispatchKeyShortcutEvent(KeyEvent event)

被调用来处理键快捷键事件。
boolean dispatchPopulateAccessibilityEvent(AccessibilityEvent event)

打电话来处理 AccessibilityEvent的人口。
boolean dispatchTouchEvent(MotionEvent ev)

被调用来处理触摸屏事件。
boolean dispatchTrackballEvent(MotionEvent ev)

被称为处理轨迹球事件。
View findViewById(int id)

使用给定的标识符查找子视图。
ActionBar getActionBar()

检索连接到此对话框的 ActionBar （如果存在）。
final Context getContext()

检索此对话框正在运行的上下文。
View getCurrentFocus()

如果此活动返回当前聚焦的视图，则在窗口上调用 getCurrentFocus() 。
LayoutInflater getLayoutInflater()
final Activity getOwnerActivity()

返回拥有此对话框的活动。
final SearchEvent getSearchEvent()

在onSearchRequested（）回调期间，该函数将返回触发回调的 SearchEvent （如果存在）。
final int getVolumeControlStream()
Window getWindow()

检索活动的当前窗口。
void hide()

隐藏对话框，但不要忽略它。
void invalidateOptionsMenu()
boolean isShowing()
void onActionModeFinished(ActionMode mode)

当动作模式完成时调用。 请注意，如果您重写此方法，则应始终通过调用super.onActionModeFinished（mode）调用超类实现。
void onActionModeStarted(ActionMode mode)

当动作模式已启动时调用。 请注意，如果您重写此方法，则应始终通过调用super.onActionModeStarted（mode）调用超类实现。
void onAttachedToWindow()

当窗口已连接到窗口管理器时调用。
void onBackPressed()

当对话框检测到用户按下后退键时调用。
void onContentChanged()

只要屏幕的内容视图发生变化（由于致电 Window.setContentView或 Window.addContentView ）， Window.setContentView调用此钩子。
boolean onContextItemSelected(MenuItem item)
void onContextMenuClosed(Menu menu)
void onCreateContextMenu(ContextMenu menu, View v, ContextMenu.ContextMenuInfo menuInfo)

在构建此视图的上下文菜单时调用。
boolean onCreateOptionsMenu(Menu menu)

如果客户需要与此对话框相同的菜单，将此呼叫代理给所有者活动 onCreateOptionsMenu(Menu)通常是安全的。
boolean onCreatePanelMenu(int featureId, Menu menu)

初始化面板'featureId'的菜单内容。
View onCreatePanelView(int featureId)

实例化视图以显示在“featureId”的面板中。
void onDetachedFromWindow()

当窗口已连接到窗口管理器时调用。
boolean onGenericMotionEvent(MotionEvent event)

当通用运动事件未被对话框中的任何视图处理时调用。
boolean onKeyDown(int keyCode, KeyEvent event)

一键被按下。
boolean onKeyLongPress(int keyCode, KeyEvent event)

默认实现 KeyEvent.Callback.onKeyLongPress() ：始终返回false（不处理事件）。
boolean onKeyMultiple(int keyCode, int repeatCount, KeyEvent event)

默认实现 KeyEvent.Callback.onKeyMultiple() ：始终返回false（不处理事件）。
boolean onKeyShortcut(int keyCode, KeyEvent event)

当对话框中的任何视图未处理键快捷键事件时调用。
boolean onKeyUp(int keyCode, KeyEvent event)

一个关键被释放。
boolean onMenuItemSelected(int featureId, MenuItem item)

当用户选择了面板的菜单项时调用。
boolean onMenuOpened(int featureId, Menu menu)

用户打开面板菜单时调用。
boolean onOptionsItemSelected(MenuItem item)
void onOptionsMenuClosed(Menu menu)
void onPanelClosed(int featureId, Menu menu)

当面板关闭时调用。
boolean onPrepareOptionsMenu(Menu menu)

如果客户需要与该对话框相同的菜单，将此呼叫代理给所有者活动 onPrepareOptionsMenu(Menu)通常是安全的。
boolean onPreparePanel(int featureId, View view, Menu menu)

准备要显示的面板。
void onRestoreInstanceState(Bundle savedInstanceState)

从先前保存的包中恢复对话框的状态。
Bundle onSaveInstanceState()

将对话框的状态保存到一个包中。
boolean onSearchRequested(SearchEvent searchEvent)

当用户发出开始搜索的愿望时，这个钩子被调用。
boolean onSearchRequested()

当用户发出开始搜索的愿望时，这个钩子被调用。
boolean onTouchEvent(MotionEvent event)

当触摸屏事件未被其下的任何视图处理时调用。
boolean onTrackballEvent(MotionEvent event)

当轨迹球被移动并且不被任何活动内部的视图处理时调用。
void onWindowAttributesChanged(WindowManager.LayoutParams params)

这在每当当前窗口属性改变时被调用。
void onWindowFocusChanged(boolean hasFocus)

这个钩子在窗口焦点改变时被调用。
ActionMode onWindowStartingActionMode(ActionMode.Callback callback)

当此窗口的动作模式正在启动时调用。
ActionMode onWindowStartingActionMode(ActionMode.Callback callback, int type)

当此窗口的动作模式正在启动时调用。
void openContextMenu(View view)
void openOptionsMenu()
void registerForContextMenu(View view)
final boolean requestWindowFeature(int featureId)

启用扩展窗口功能。
void setCancelMessage(Message msg)

设置对话框取消时发送的消息。
void setCancelable(boolean flag)

使用 BACK键设置是否可以取消该对话框。
void setCanceledOnTouchOutside(boolean cancel)

设置在窗口边界之外触摸时是否取消该对话框。
void setContentView(int layoutResID)

从布局资源中设置屏幕内容。
void setContentView(View view, ViewGroup.LayoutParams params)

将屏幕内容设置为明确的视图。
void setContentView(View view)

将屏幕内容设置为明确的视图。
void setDismissMessage(Message msg)

设置消息在对话框关闭时发送。
final void setFeatureDrawable(int featureId, Drawable drawable)

方便拨打 setFeatureDrawable(int, Drawable) 。
final void setFeatureDrawableAlpha(int featureId, int alpha)

方便拨打 setFeatureDrawableAlpha(int, int) 。
final void setFeatureDrawableResource(int featureId, int resId)

方便拨打 setFeatureDrawableResource(int, int) 。
final void setFeatureDrawableUri(int featureId, Uri uri)

方便拨打 setFeatureDrawableUri(int, Uri) 。
void setOnCancelListener(DialogInterface.OnCancelListener listener)

设置一个侦听器，当对话框被取消时被调用。
void setOnDismissListener(DialogInterface.OnDismissListener listener)

设置一个侦听器，当对话框被解除时被调用。
void setOnKeyListener(DialogInterface.OnKeyListener onKeyListener)

设置将密钥分派到对话框时将要调用的回调。
void setOnShowListener(DialogInterface.OnShowListener listener)

设置显示对话框时要调用的侦听器。
final void setOwnerActivity(Activity activity)

设置拥有此对话框的活动。
void setTitle(CharSequence title)

为此对话框的窗口设置标题文本。
void setTitle(int titleId)

为此对话框的窗口设置标题文本。
final void setVolumeControlStream(int streamType)

默认情况下，这将使用所有者Activity的建议流类型。
void show()

启动对话框并将其显示在屏幕上。
void takeKeyEvents(boolean get)

请求重要事件进入该对话框。
void unregisterForContextMenu(View view)

Protected methods
void onCreate(Bundle savedInstanceState)

与 onCreate(Bundle)类似，您应该使用此方法初始化对话框，包括调用 setContentView(View) 。
void onStart()

当对话开始时调用。
void onStop()

打电话告诉你，你正在停止。

Inherited methods
From class java.lang.Object
From interface android.content.DialogInterface
From interface android.view.Window.Callback
From interface android.view.KeyEvent.Callback
From interface android.view.View.OnCreateContextMenuListener

Public constructors

Dialog

Added in API level 1 
Dialog (Context context)

创建一个使用默认对话框主题的对话窗口。

提供的 context用于获取用于显示对话框的窗口管理器和基本主题。

Parameters
context Context: the context in which the dialog should run

也可以看看：

Dialog

Added in API level 1 
Dialog (Context context, 
                int themeResId)

创建一个使用自定义对话框样式的对话窗口。

提供的 context用于获取用于显示对话框的窗口管理器和基本主题。

提供的theme应用于上下文主题之上。 有关定义和使用样式的更多信息，请参阅Style and Theme Resources 。

Parameters
context Context: the context in which the dialog should run
themeResId int: a style resource describing the theme to use for the window, or 0 to use the default dialog theme

Protected constructors

Dialog

Added in API level 1 
Dialog (Context context, 
                boolean cancelable, 
                DialogInterface.OnCancelListener cancelListener)

Parameters
context Context
cancelable boolean
cancelListener DialogInterface.OnCancelListener

Public methods

addContentView

Added in API level 1 
void addContentView (View view, 
                ViewGroup.LayoutParams params)

在屏幕上添加一个额外的内容视图。 在屏幕中的现有视图之后添加 - 现有视图不会被删除。

Parameters
view View: The desired content to display.
params ViewGroup.LayoutParams: Layout parameters for the view.

cancel

Added in API level 1 
void cancel ()

取消对话框。 这与调用dismiss()基本相同，但它也会调用您的DialogInterface.OnCancelListener （如果已注册）。

closeOptionsMenu

Added in API level 1 
void closeOptionsMenu ()

也可以看看：

create

Added in API level 21 
void create ()

强制立即创建对话框。

请注意，您不应该重写此方法来执行对话框创建。 相反，覆盖onCreate(Bundle) 。

dismiss

Added in API level 1 
void dismiss ()

关闭此对话框，将其从屏幕上移除。 这个方法可以从任何线程安全地调用。 请注意，当对话框关闭时，您不应该重写此方法来执行清理，而应该在onStop()执行该onStop() 。

dispatchGenericMotionEvent

Added in API level 12 
boolean dispatchGenericMotionEvent (MotionEvent ev)

被调用来处理通用运动事件。 您可以覆盖它，以便在将所有通用运动事件分派到窗口之前拦截它们。 一定要为通常应该正常处理的通用运动事件调用此实现。

Parameters
ev MotionEvent: The generic motion event.
Returns
boolean boolean Return true if this event was consumed.

dispatchKeyEvent

Added in API level 1 
boolean dispatchKeyEvent (KeyEvent event)

被调用来处理关键事件。 您可以覆盖它以在将所有关键事件分派到窗口之前拦截它们。 确保为应该正常处理的关键事件调用此实现。

Parameters
event KeyEvent: The key event.
Returns
boolean boolean Return true if this event was consumed.

dispatchKeyShortcutEvent

Added in API level 11 
boolean dispatchKeyShortcutEvent (KeyEvent event)

被调用来处理键快捷键事件。 您可以重写此选项，以便在将所有快捷键事件分派到窗口之前拦截它们。 确保为应该正常处理的键快捷键事件调用此实现。

Parameters
event KeyEvent: The key shortcut event.
Returns
boolean True if this event was consumed.

dispatchPopulateAccessibilityEvent

Added in API level 4 
boolean dispatchPopulateAccessibilityEvent (AccessibilityEvent event)

打电话来处理 AccessibilityEvent的人口。

Parameters
event AccessibilityEvent: The event.
Returns
boolean boolean Return true if event population was completed.

dispatchTouchEvent

Added in API level 1 
boolean dispatchTouchEvent (MotionEvent ev)

被调用来处理触摸屏事件。 您可以覆盖此选项，以便在将所有触摸屏事件分派到窗口之前拦截它们。 请务必将此实现称为应该正常处理的触摸屏事件。

Parameters
ev MotionEvent: The touch screen event.
Returns
boolean boolean Return true if this event was consumed.

dispatchTrackballEvent

Added in API level 1 
boolean dispatchTrackballEvent (MotionEvent ev)

被称为处理轨迹球事件。 您可以覆盖此选项，以便在将所有轨迹球事件分派到窗口之前拦截它们。 请务必将此实施称为应正常处理的轨迹球事件。

Parameters
ev MotionEvent: The trackball event.
Returns
boolean boolean Return true if this event was consumed.

findViewById

Added in API level 1 
View findViewById (int id)

使用给定的标识符查找子视图。 如果指定的子视图不存在或对话框尚未完全创建（例如，通过show()或create() ），则返回null。

Parameters
id int: the identifier of the view to find
Returns
View The view with the given id or null.

getActionBar

Added in API level 11 
ActionBar getActionBar ()

检索连接到此对话框的 ActionBar （如果存在）。

Returns
ActionBar The ActionBar attached to the dialog or null if no ActionBar is present.

getContext

Added in API level 1 
Context getContext ()

检索此对话框正在运行的上下文。

Returns
Context Context The Context used by the Dialog.

getCurrentFocus

Added in API level 1 
View getCurrentFocus ()

如果此活动返回当前聚焦的视图，则在Window上调用 getCurrentFocus() 。

Returns
View View The current View with focus or null.

也可以看看：

getLayoutInflater

Added in API level 1 
LayoutInflater getLayoutInflater ()

Returns
LayoutInflater

getOwnerActivity

Added in API level 1 
Activity getOwnerActivity ()

返回拥有此对话框的活动。 例如，如果使用showDialog(int)来显示此对话框，则该活动将是所有者（默认情况下）。 根据这个对话框的创建方式，这可能返回null。

Returns
Activity The Activity that owns this Dialog.

getSearchEvent

Added in API level 23 
SearchEvent getSearchEvent ()

在onSearchRequested（）回调期间，该函数将返回触发回调的 SearchEvent （如果存在）。

Returns
SearchEvent SearchEvent The SearchEvent that triggered the onSearchRequested() callback.

getVolumeControlStream

Added in API level 1 
int getVolumeControlStream ()

Returns
int

也可以看看：

getWindow

Added in API level 1 
Window getWindow ()

检索活动的当前窗口。 这可以用来直接访问通过活动/屏幕不可用的部分Window API。

Returns
Window Window The current window, or null if the activity is not visual.

hide

Added in API level 1 
void hide ()

隐藏对话框，但不要忽略它。

invalidateOptionsMenu

Added in API level 11 
void invalidateOptionsMenu ()

也可以看看：

isShowing

Added in API level 1 
boolean isShowing ()

Returns
boolean Whether the dialog is currently showing.

onActionModeFinished

Added in API level 11 
void onActionModeFinished (ActionMode mode)

当动作模式完成时调用。 适当的模式回调方法已经被调用。 请注意，如果您重写此方法，则应始终通过调用super.onActionModeFinished（mode）调用超类实现。

Parameters
mode ActionMode: The mode that was just finished.

onActionModeStarted

Added in API level 11 
void onActionModeStarted (ActionMode mode)

当动作模式已启动时调用。 适当的模式回调方法已经被调用。 请注意，如果您重写此方法，则应始终通过调用super.onActionModeStarted（mode）调用超类实现。

Parameters
mode ActionMode: The new mode that has just been started.

onAttachedToWindow

Added in API level 5 
void onAttachedToWindow ()

当窗口已连接到窗口管理器时调用。 有关更多信息，请参阅View.onAttachedToWindow() 。

onBackPressed

Added in API level 5 
void onBackPressed ()

当对话框检测到用户按下后退键时调用。 默认实现简单地取消对话框（仅当它是可取消的时候），但是您可以覆盖此对话框以执行任何您想要的操作。

onContentChanged

Added in API level 1 
void onContentChanged ()

只要屏幕的内容视图发生变化（由于致电 Window.setContentView或 Window.addContentView ）， Window.setContentView调用此钩子。

onContextItemSelected

Added in API level 1 
boolean onContextItemSelected (MenuItem item)

Parameters
item MenuItem
Returns
boolean

也可以看看：

onContextMenuClosed

Added in API level 1 
void onContextMenuClosed (Menu menu)

Parameters
menu Menu

也可以看看：

onCreateContextMenu

Added in API level 1 
void onCreateContextMenu (ContextMenu menu, 
                View v, 
                ContextMenu.ContextMenuInfo menuInfo)

在构建此视图的上下文菜单时调用。 此方法返回后，保持菜单不安全。

Parameters
menu ContextMenu: The context menu that is being built
v View: The view for which the context menu is being built
menuInfo ContextMenu.ContextMenuInfo: Extra information about the item for which the context menu should be shown. This information will vary depending on the class of v.

也可以看看：

onCreateOptionsMenu

Added in API level 1 
boolean onCreateOptionsMenu (Menu menu)

如果客户需要与该对话框相同的菜单，将此呼叫代理给所有者活动 onCreateOptionsMenu(Menu)通常是安全的。

Parameters
menu Menu
Returns
boolean

也可以看看：

onCreatePanelMenu

Added in API level 1 
boolean onCreatePanelMenu (int featureId, 
                Menu menu)

初始化面板'featureId'的菜单内容。 如果onCreatePanelView（）返回null，这会被调用，为您提供一个标准菜单，您可以在其中放置项目。 它仅在面板显示时才被调用一次。

您可以安全地按住 菜单 （以及从中创建的任何项目），根据需要对其进行修改，直到下次为此功能调用onCreatePanelMenu（）。

Parameters
featureId int: The panel being created.
menu Menu: The menu inside the panel.
Returns
boolean boolean You must return true for the panel to be displayed; if you return false it will not be shown.

也可以看看：

onCreatePanelView

Added in API level 1 
View onCreatePanelView (int featureId)

实例化视图以显示在“featureId”的面板中。 您可以返回null，在这种情况下，将为您创建默认内容（通常是菜单）。

Parameters
featureId int: Which panel is being created.
Returns
View view The top-level view to place in the panel.

也可以看看：

onDetachedFromWindow

Added in API level 5 
void onDetachedFromWindow ()

当窗口已连接到窗口管理器时调用。 有关更多信息，请参阅View.onDetachedFromWindow() 。

onGenericMotionEvent

Added in API level 12 
boolean onGenericMotionEvent (MotionEvent event)

当通用运动事件未被对话框中的任何视图处理时调用。

通用运动事件描述操纵杆运动，鼠标悬停，触控板触摸，滚轮运动和其他输入事件。 运动事件的source指定接收到的输入类。 此方法的实现必须在处理事件之前检查源中的位。 以下代码示例显示了这是如何完成的。

源类为SOURCE_CLASS_POINTER通用运动事件传递到指针下的视图。 所有其他通用运动事件都会传送到重点视图。

有关如何处理此事件的示例，请参阅 onGenericMotionEvent(MotionEvent) 。

Parameters
event MotionEvent: The generic motion event being processed.
Returns
boolean Return true if you have consumed the event, false if you haven't. The default implementation always returns false.

onKeyDown

Added in API level 1 
boolean onKeyDown (int keyCode, 
                KeyEvent event)

一键被按下。

如果重点视图不想要这个事件，则调用此方法。

默认实现使用KEYCODE_BACK以稍后在 onKeyUp(int, KeyEvent)处理它。

Parameters
keyCode int: The value in event.getKeyCode().
event KeyEvent: Description of the key event.
Returns
boolean If you handled the event, return true. If you want to allow the event to be handled by the next receiver, return false.

也可以看看：

onKeyLongPress

Added in API level 5 
boolean onKeyLongPress (int keyCode, 
                KeyEvent event)

默认实现 KeyEvent.Callback.onKeyLongPress() ：始终返回false（不处理事件）。

Parameters
keyCode int: The value in event.getKeyCode().
event KeyEvent: Description of the key event.
Returns
boolean If you handled the event, return true. If you want to allow the event to be handled by the next receiver, return false.

onKeyMultiple

Added in API level 1 
boolean onKeyMultiple (int keyCode, 
                int repeatCount, 
                KeyEvent event)

默认实现 KeyEvent.Callback.onKeyMultiple() ：始终返回false（不处理事件）。

Parameters
keyCode int: The value in event.getKeyCode().
repeatCount int: Number of pairs as returned by event.getRepeatCount().
event KeyEvent: Description of the key event.
Returns
boolean If you handled the event, return true. If you want to allow the event to be handled by the next receiver, return false.

onKeyShortcut

Added in API level 11 
boolean onKeyShortcut (int keyCode, 
                KeyEvent event)

当对话框中的任何视图未处理键快捷键事件时调用。 重写此方法以实现对话框的全局快捷键。 快捷键也可以通过设置菜单项的shortcut属性来实现。

Parameters
keyCode int: The value in event.getKeyCode().
event KeyEvent: Description of the key event.
Returns
boolean True if the key shortcut was handled.

onKeyUp

Added in API level 1 
boolean onKeyUp (int keyCode, 
                KeyEvent event)

一个关键被释放。

缺省实现处理KEYCODE_BACK以关闭对话框。

Parameters
keyCode int: The value in event.getKeyCode().
event KeyEvent: Description of the key event.
Returns
boolean If you handled the event, return true. If you want to allow the event to be handled by the next receiver, return false.

也可以看看：

onMenuItemSelected

Added in API level 1 
boolean onMenuItemSelected (int featureId, 
                MenuItem item)

当用户选择了面板的菜单项时调用。

Parameters
featureId int: The panel that the menu is in.
item MenuItem: The menu item that was selected.
Returns
boolean boolean Return true to finish processing of selection, or false to perform the normal menu handling (calling its Runnable or sending a Message to its target Handler).

也可以看看：

onMenuOpened

Added in API level 1 
boolean onMenuOpened (int featureId, 
                Menu menu)

用户打开面板菜单时调用。 当菜单从一种类型更改为另一种时（例如，从图标菜单变为扩展菜单），也可能会调用此功能。

Parameters
featureId int: The panel that the menu is in.
menu Menu: The menu that is opened.
Returns
boolean Return true to allow the menu to open, or false to prevent the menu from opening.

也可以看看：

onOptionsItemSelected

Added in API level 1 
boolean onOptionsItemSelected (MenuItem item)

Parameters
item MenuItem
Returns
boolean

也可以看看：

onOptionsMenuClosed

Added in API level 1 
void onOptionsMenuClosed (Menu menu)

Parameters
menu Menu

也可以看看：

onPanelClosed

Added in API level 1 
void onPanelClosed (int featureId, 
                Menu menu)

当面板关闭时调用。 如果正在打开另一个逻辑后续面板（并且该面板正在关闭以为后面的面板腾出空间），则不会调用此方法。

Parameters
featureId int: The panel that is being displayed.
menu Menu: If onCreatePanelView() returned null, this is the Menu being displayed in the panel.

也可以看看：

onPrepareOptionsMenu

Added in API level 1 
boolean onPrepareOptionsMenu (Menu menu)

如果客户希望为该对话框使用相同的菜单，将此呼叫代理给所有者活动 onPrepareOptionsMenu(Menu)通常是安全的。

Parameters
menu Menu
Returns
boolean

也可以看看：

onPreparePanel

Added in API level 1 
boolean onPreparePanel (int featureId, 
                View view, 
                Menu menu)

准备要显示的面板。 在每次显示面板窗口之前调用它。

Parameters
featureId int: The panel that is being displayed.
view View: The View that was returned by onCreatePanelView().
menu Menu: If onCreatePanelView() returned null, this is the Menu being displayed in the panel.
Returns
boolean boolean You must return true for the panel to be displayed; if you return false it will not be shown.

也可以看看：

onRestoreInstanceState

Added in API level 1 
void onRestoreInstanceState (Bundle savedInstanceState)

从先前保存的包中恢复对话框的状态。 默认实现会恢复保存在默认实现onSaveInstanceState()中的对话框视图层次的onSaveInstanceState() ，因此，除非您想自己完成所有状态的恢复，否则请务必在覆盖时调用超级对象。

Parameters
savedInstanceState Bundle: The state of the dialog previously saved by onSaveInstanceState().

onSaveInstanceState

Added in API level 1 
Bundle onSaveInstanceState ()

将对话框的状态保存到一个包中。 默认的实现保存了它的视图层次结构的状态，所以如果你重写这个来保存更多的状态，你可能想要调用super。

Returns
Bundle A bundle with the state of the dialog.

onSearchRequested

Added in API level 23 
boolean onSearchRequested (SearchEvent searchEvent)

当用户发出开始搜索的愿望时，这个钩子被调用。

Parameters
searchEvent SearchEvent: A SearchEvent describing the signal to start a search.
Returns
boolean true if search launched, false if activity refuses (blocks)

onSearchRequested

Added in API level 1 
boolean onSearchRequested ()

当用户发出开始搜索的愿望时，这个钩子被调用。

Returns
boolean true if search launched, false if activity refuses (blocks)

onTouchEvent

Added in API level 1 
boolean onTouchEvent (MotionEvent event)

当触摸屏事件未被其下的任何视图处理时调用。 这对于处理发生在窗口范围之外的触摸事件非常有用，在那里没有接收它的视图。

Parameters
event MotionEvent: The touch screen event being processed.
Returns
boolean Return true if you have consumed the event, false if you haven't. The default implementation will cancel the dialog when a touch happens outside of the window bounds.

onTrackballEvent

Added in API level 1 
boolean onTrackballEvent (MotionEvent event)

当轨迹球被移动并且不被任何活动内部的视图处理时调用。 因此，例如，如果轨迹球在焦点位于按钮上时移动，您将在此处接到呼叫，因为按钮通常不会对轨迹球事件做任何事情。 这里的调用发生在轨迹球移动转换为DPAD关键事件之前，然后发送回视图层次结构，并在焦点导航等事件处理。

Parameters
event MotionEvent: The trackball event being processed.
Returns
boolean Return true if you have consumed the event, false if you haven't. The default implementation always returns false.

onWindowAttributesChanged

Added in API level 1 
void onWindowAttributesChanged (WindowManager.LayoutParams params)

这在每当当前窗口属性改变时被调用。

Parameters
params WindowManager.LayoutParams

onWindowFocusChanged

Added in API level 1 
void onWindowFocusChanged (boolean hasFocus)

这个钩子在窗口焦点改变时被调用。 有关更多信息，请参阅View.onWindowFocusChangedNotLocked(boolean) 。

Parameters
hasFocus boolean: Whether the window now has focus.

onWindowStartingActionMode

Added in API level 11 
ActionMode onWindowStartingActionMode (ActionMode.Callback callback)

当此窗口的动作模式正在启动时调用。 给回调提供了一个机会，以自己独特而美丽的方式处理动作模式。 如果此方法返回null，则系统可以选择一种呈现模式的方式或根本不选择启动模式。 这相当于onWindowStartingActionMode(android.view.ActionMode.Callback, int)和TYPE_PRIMARY 。

Parameters
callback ActionMode.Callback: Callback to control the lifecycle of this action mode
Returns
ActionMode The ActionMode that was started, or null if the system should present it

onWindowStartingActionMode

Added in API level 23 
ActionMode onWindowStartingActionMode (ActionMode.Callback callback, 
                int type)

当此窗口的动作模式正在启动时调用。 给回调提供了一个机会，以自己独特而美丽的方式处理动作模式。 如果此方法返回null，则系统可以选择一种呈现模式的方式或根本不选择启动模式。

Parameters
callback ActionMode.Callback: Callback to control the lifecycle of this action mode
type int: One of TYPE_PRIMARY or TYPE_FLOATING.
Returns
ActionMode The ActionMode that was started, or null if the system should present it

openContextMenu

Added in API level 1 
void openContextMenu (View view)

Parameters
view View

也可以看看：

openOptionsMenu

Added in API level 1 
void openOptionsMenu ()

也可以看看：

registerForContextMenu

Added in API level 1 
void registerForContextMenu (View view)

Parameters
view View

也可以看看：

requestWindowFeature

Added in API level 1 
boolean requestWindowFeature (int featureId)

启用扩展窗口功能。 这是拨打getWindow().requestFeature()的便利getWindow().requestFeature() 。

Parameters
featureId int: The desired feature as defined in Window.
Returns
boolean Returns true if the requested feature is supported and now enabled.

也可以看看：

setCancelMessage

Added in API level 1 
void setCancelMessage (Message msg)

设置对话框取消时发送的消息。

Parameters
msg Message: The msg to send when the dialog is canceled.

也可以看看：

setCancelable

Added in API level 1 
void setCancelable (boolean flag)

使用 BACK密钥设置是否可以取消该对话框。

Parameters
flag boolean

setCanceledOnTouchOutside

Added in API level 1 
void setCanceledOnTouchOutside (boolean cancel)

设置在窗口边界之外触摸时是否取消该对话框。 如果设置为true，则对话框设置为可取消（如果尚未设置）。

Parameters
cancel boolean: Whether the dialog should be canceled when touched outside the window.

setContentView

Added in API level 1 
void setContentView (int layoutResID)

从布局资源中设置屏幕内容。 资源将被夸大，将所有顶级视图添加到屏幕上。

Parameters
layoutResID int: Resource ID to be inflated.

setContentView

Added in API level 1 
void setContentView (View view, 
                ViewGroup.LayoutParams params)

将屏幕内容设置为明确的视图。 该视图直接放置在屏幕的视图层次结构中。 它本身可能是一个复杂的视图层次结构。

Parameters
view View: The desired content to display.
params ViewGroup.LayoutParams: Layout parameters for the view.

setContentView

Added in API level 1 
void setContentView (View view)

将屏幕内容设置为明确的视图。 该视图直接放置在屏幕的视图层次结构中。 它本身可能是一个复杂的视图层次结构。

Parameters
view View: The desired content to display.

setDismissMessage

Added in API level 1 
void setDismissMessage (Message msg)

设置消息在对话框关闭时发送。

Parameters
msg Message: The msg to send when the dialog is dismissed.

setFeatureDrawable

Added in API level 1 
void setFeatureDrawable (int featureId, 
                Drawable drawable)

方便拨打 setFeatureDrawable(int, Drawable) 。

Parameters
featureId int
drawable Drawable

setFeatureDrawableAlpha

Added in API level 1 
void setFeatureDrawableAlpha (int featureId, 
                int alpha)

方便拨打 setFeatureDrawableAlpha(int, int) 。

Parameters
featureId int
alpha int

setFeatureDrawableResource

Added in API level 1 
void setFeatureDrawableResource (int featureId, 
                int resId)

方便拨打 setFeatureDrawableResource(int, int) 。

Parameters
featureId int
resId int

setFeatureDrawableUri

Added in API level 1 
void setFeatureDrawableUri (int featureId, 
                Uri uri)

方便拨打 setFeatureDrawableUri(int, Uri) 。

Parameters
featureId int
uri Uri

setOnCancelListener

Added in API level 1 
void setOnCancelListener (DialogInterface.OnCancelListener listener)

设置一个侦听器，当对话框被取消时被调用。

这只会在对话框被取消时被调用。 单独取消事件不会捕获对话可能被解雇的所有方式。 如果创建者需要知道对话何时会被解除，请使用setOnDismissListener(DialogInterface.OnDismissListener) 。

Parameters
listener DialogInterface.OnCancelListener: The DialogInterface.OnCancelListener to use.

setOnDismissListener

Added in API level 1 
void setOnDismissListener (DialogInterface.OnDismissListener listener)

设置一个侦听器，当对话框被解除时被调用。

Parameters
listener DialogInterface.OnDismissListener: The DialogInterface.OnDismissListener to use.

setOnKeyListener

Added in API level 1 
void setOnKeyListener (DialogInterface.OnKeyListener onKeyListener)

设置将密钥分派到对话框时将要调用的回调。

Parameters
onKeyListener DialogInterface.OnKeyListener

setOnShowListener

Added in API level 8 
void setOnShowListener (DialogInterface.OnShowListener listener)

设置显示对话框时要调用的侦听器。

Parameters
listener DialogInterface.OnShowListener: The DialogInterface.OnShowListener to use.

setOwnerActivity

Added in API level 1 
void setOwnerActivity (Activity activity)

设置拥有此对话框的活动。 使用示例：此对话框将使用活动的建议音量控制流。

Parameters
activity Activity: The Activity that owns this dialog.

setTitle

Added in API level 1 
void setTitle (CharSequence title)

为此对话框的窗口设置标题文本。

Parameters
title CharSequence: The new text to display in the title.

setTitle

Added in API level 1 
void setTitle (int titleId)

为此对话框的窗口设置标题文本。 使用提供的标识符从资源中检索文本。

Parameters
titleId int: the title's text resource identifier

setVolumeControlStream

Added in API level 1 
void setVolumeControlStream (int streamType)

默认情况下，这将使用所有者Activity的建议流类型。

Parameters
streamType int

也可以看看：

show

Added in API level 1 
void show ()

启动对话框并将其显示在屏幕上。 该窗口放置在应用程序层并且不透明。 请注意，当显示对话框时，您不应该重写此方法来执行初始化，而是在onStart()执行该onStart() 。

takeKeyEvents

Added in API level 1 
void takeKeyEvents (boolean get)

请求重要事件进入该对话框。 如果你的对话框没有焦点的视图，但是对话框仍然希望有机会处理关键事件，请使用它。

Parameters
get boolean: true if the dialog should receive key events, false otherwise

也可以看看：

unregisterForContextMenu

Added in API level 1 
void unregisterForContextMenu (View view)

Parameters
view View

也可以看看：

Protected methods

onCreate

Added in API level 1 
void onCreate (Bundle savedInstanceState)

与 onCreate(Bundle)类似，您应该使用此方法初始化对话框，包括调用 setContentView(View) 。

Parameters
savedInstanceState Bundle: If this dialog is being reinitialized after a the hosting activity was previously shut down, holds the result from the most recent call to onSaveInstanceState(), or null if this is the first time.

onStart

Added in API level 1 
void onStart ()

当对话开始时调用。

onStop

Added in API level 1 
void onStop ()

打电话告诉你，你正在停止。

Android开发手册

Hooray!