到顶部
Android API
java.lang.Object(java.lang.对象)
    android内容。上下文
      android内容。上下文包装器
        android.view。上下文主题包装器
          android应用程序。活动
已知的直接子类
已知间接子类

课程概述

活动是用户可以做的一件单一、专注的事情活动与用户交互,因此Activity类负责为您创建一个窗口,您可以在其中放置UIsetContentView(视图)虽然活动经常呈现给用户作为全屏窗口,它们还可以以其他方式使用:作为浮动窗口窗口(通过主题窗口是浮动的套)或嵌入到另一个活动中(使用活动组).几乎所有Activity子类都将实现两种方法:

与一起使用上下文.startActivity(),全部活动类必须具有相应的<活动>在其包中的声明雄激素清单.xml.

此处涵盖的主题:

  1. 碎片
  2. 活动生命周期
  3. 配置更改
  4. 开始活动并获得结果
  5. 保存持久状态
  6. 权限
  7. 整个生命周期

开发人员指南

Activity类是应用程序整个生命周期的重要组成部分,活动的启动和组合方式是一个基本原则平台应用程序模型的一部分。有关Android应用程序和活动行为,请阅读应用程序基础任务和后堆栈开发人员指南。

您还可以在中找到有关如何创建活动的详细讨论活动开发人员指南。

碎片

从开始蜂巢,活动实现可以利用碎片等级提高到更好模块化他们的代码,构建更复杂的用户界面屏幕,并帮助在大小屏幕之间缩放应用程序。

活动生命周期

系统中的活动作为活动堆栈.当一个新活动开始时,它被放在堆栈的顶部并成为正在运行的活动--以前的活动始终保持不变在堆栈中位于其下方,直到新活动退出。

活动基本上有四种状态:

  • 如果屏幕前景中的活动(位于堆叠),是的积极的运行.
  • 如果活动失去焦点但仍然可见(即新的非全尺寸或者透明活动将重点放在您的活动之上)暂停。暂停的活动完全处于活动状态(它维护所有州和成员信息,并始终附加到窗口管理器),但在极端情况下可能会被系统杀死内存不足的情况。
  • 如果一个活动被另一个活动完全遮挡,是的停止。它仍然保留所有状态和成员信息,但是,它对用户不再可见,因此其窗口被隐藏当需要内存时,它通常会被系统杀死其他地方。
  • 如果活动暂停或停止,系统可以删除该活动通过要求它完成,或者干脆终止它过程。当它再次显示给用户时,必须完全重新启动并恢复到以前的状态。

下图显示了“活动”的重要状态路径。方形矩形表示可以实现的回调方法当“活动”在状态之间移动时执行操作。有色人种椭圆是“活动”可以处于的主要状态。

Android活动生命周期的状态图。

您可能有兴趣在您的活动:

  • 这个整个使用寿命在第一次调用之间发生活动onCreate(捆绑包)直到最后一次通话onDestroy()。一个活动将完成所有设置onCreate()中的“全局”状态,并释放中的所有剩余资源onDestroy()。例如,如果它有一个线程在后台运行要从网络下载数据,可以在onCreate()中创建该线程然后在onDestroy()中停止线程。
  • 这个可见寿命活动的启动()直到相应的调用onStop()。在此期间,用户可以看到屏幕上的活动,尽管它可能不在前台并且没有交互与用户一起。在这两种方法之间,您可以维护以下资源需要向用户显示活动。例如,您可以注册广播接收机在onStart()中监视更改这会影响您的UI,当用户没有longer可以看到您正在显示的内容。onStart()和onStop()方法当活动变得可见和隐藏时,可以多次调用发送给用户。
  • 这个前台寿命活动的onResume()直到相应的调用onPause()。在此期间,活动是在所有其他活动之前并与用户交互。一项活动可以经常在恢复状态和暂停状态之间切换,例如当发送活动结果时,当新的意图已交付--因此这些方法中的代码应该是公平的重量轻。

活动的整个生命周期由以下内容定义活动方法。所有这些都是可以覆盖的挂钩以在活动更改状态时进行适当的工作。全部活动将实施onCreate(捆绑包)进行初始设置;许多人也将实施onPause()提交对数据的更改,以及否则,准备停止与用户交互。你应该永远在实现这些方法时调用超类。

公共类Activity扩展ApplicationContext{protected void onCreate(Bundle savedInstanceState);protected void on开始();protected void onRestart();protected void onResume();protected void onPause();protected void onStop();protected void onDestroy();}

通常,活动生命周期的移动看起来像这个:

方法 说明 杀人? 下一步
创建时() 首次创建活动时调用。这是您应该进行所有正常静态设置的地方:创建视图,将数据绑定到列表等。此方法还为您提供了一个包含活动先前冻结状态,如果有的话。

始终后跟启动().

启动()
     重新启动() 在您的活动停止后、停止前调用又开始了。

总是跟在后面启动()

启动()
启动() 当活动对用户可见时调用。

然后onResume()如果有活动到前台,或者onStop()如果它被隐藏了。

onResume()onStop()
     onResume() 活动开始时调用与用户交互。此时,您的活动处于活动堆栈的顶部,其中包含用户输入。

始终后跟on暂停().

onPause()
onPause() 当系统即将开始恢复上一个时调用活动。这通常用于将未保存的更改提交给持久数据、停止动画和其他可能消耗的东西CPU等。此方法的实现必须非常快,因为在该方法返回之前,不会恢复下一个活动。

然后是其中之一onResume()如果活动回到前面,或onStop()如果它变成用户不可见。

预处理-蜂巢 onResume()
onStop()
onStop() 当用户不再看到活动时调用,因为另一项活动已经恢复,正在报道这项活动。这个可能是因为正在启动新活动一个被带到这个前面,或者这个被摧毁。

然后是其中之一重新启动()如果此活动将返回与用户交互,或on销毁()如果这项活动结束。

是的 重新启动()
onDestroy()
onDestroy() 在您的活动被破坏。这可能是因为活动正在结束(有人打电话给完成()或者因为系统暂时破坏了它活动的实例以节省空间。你可以区分在这两个场景之间使用正在完成()方法。 是的 没有什么

注意上表中的“Killable”列——对于那些标记为killable,则在该方法返回托管系统可能会终止活动在任何时候没有其他线路它的代码被执行。因此,您应该使用onPause()方法来写入任何持久数据(例如用户编辑)存储。此外,该方法onSaveInstanceState(捆绑包)在放置活动之前调用在这种后台状态下,允许您保存任何动态实例在您的活动中声明到给定的捆绑包中,稍后将在中收到onCreate(捆绑包)如果需要重新创建活动。请参阅整个生命周期有关流程生命周期如何绑定的更多信息,请参见第节它正在主持的活动。请注意,保存很重要中的持久数据onPause()而不是onSaveInstanceState(捆绑包)因为后者不是生命周期回调的一部分,所以不会在其文档中描述的任何情况下都可以调用。

请注意,这些语义在面向平台的应用程序蜂巢而不是那些针对先前平台的。从蜂巢应用程序开始在其onStop()已返回。这个影响时间onSaveInstanceState(捆绑包)可能被称为之后安全调用onPause()并允许和应用于安全等待,直到onStop()保存持久状态。

对于那些未标记为可终止的方法,活动从方法开始,系统不会终止进程调用并在返回后继续。因此,活动处于可终止状态状态,例如,在之后onPause()到的开始onResume().

配置更改

如果设备的配置(由资源。配置类)更改,然后显示用户界面的任何内容都需要更新以匹配配置。因为活动是交互的主要机制对于用户,它包括对处理配置的特殊支持变化。

除非您另有规定,否则配置更改(例如更改屏幕方向、语言、输入设备等)将导致当前活动为摧毁,正在进行正常活动生命周期过程onPause(),onStop()、和onDestroy()视情况而定。如果活动曾经位于前台或用户可见onDestroy()在该实例中调用,则活动的新实例将为使用上一个实例生成的savedInstanceState创建onSaveInstanceState(捆绑包).

这样做是因为任何应用程序资源,包括布局文件,可以根据任何配置值进行更改。因此处理配置更改的唯一安全方法是重新检索所有资源,包括布局、绘图和字符串。因为活动必须已经知道如何拯救他们的国家并从中重建自己这种状态下,这是使活动重新启动自身的一种方便方法使用新配置。

在某些特殊情况下,您可能希望绕过基于一种或多种配置更改的活动。这是已完成android:配置更改属性。对于任何类型的配置更改,您都会说如果您在那里处理,您将收到对当前活动的呼叫onConfigurationChanged(配置)方法,而不是重新启动。如果但是,配置更改涉及任何您没有处理的活动仍将重新启动,并且onConfigurationChanged(配置)不会被调用。

开始活动并获得结果

这个startActivity(目的)方法用于启动新活动,它将被放置在活动堆栈的顶部。只接受一个参数意图,其中描述了活动待执行。

有时你想从一项活动中得到一个结果末端。例如,您可以启动一个活动,让用户选择联系人列表中的人员;当它结束时,它返回该人被选中的。为此,您可以调用startActivityForResult(意向,int)第二个整数参数标识调用的版本。结果将通过您的onActivityResult(int,int,Intent)方法。

当活动退出时,它可以调用setResult(int)将数据返回到其父级。它必须始终提供结果代码,可以是标准结果RESULT_CANCELED、RESULT_OK或任何从RESULT_FIRST_USER开始的自定义值。此外,它还可以选择返回包含它想要的任何其他数据的Intent。所有这些信息显示在父母的Activity.onActivityResult(),以及整数它最初提供的标识符。

如果子活动因任何原因失败(例如崩溃),则父活动活动将收到代码为result_CANCELED的结果。

公共类MyActivity扩展Activity{...静态最终int PICK_CONTACT_REQUEST=0;protected boolean onKeyDown(int keyCode,KeyEvent事件){if(keyCode==KeyEvent.keyCode_DPAD_CENTER){//当用户中心按下时,让他们选择联系人。启动ActivityForResult(新意向(意向.ACTION_PICK,新Uri(“内容://联系人")),选择联系人);返回true;}返回false;}protected void onActivityResult(int requestCode,int resultCode,意向数据){if(请求代码==PICK_CONTACT_REQUEST){if(resultCode==RESULT_OK){//选择了一个联系人。在这里我们只显示它//发送给用户。startActivity(新Intent(Intent.ACTION_VIEW,data));}}}}

保存持久状态

与活动相比,通常有两种持久状态将处理:共享的类文档数据(通常存储在SQLite中数据库使用内容提供商)和内部状态,如用户首选项。

对于内容提供者数据,我们建议活动使用“就地编辑”用户模型。也就是说,用户所做的任何编辑都是有效的无需额外的确认步骤即可立即进行。支持此模型通常只需遵循以下两条规则:

  • 创建新文档时它会立即创建。例如,如果用户选择写入一封新的电子邮件,一旦创建了新条目开始输入数据,以便在此时,此电子邮件将显示在草稿列表中。

  • 当活动onPause()方法,它应该提交给支持内容提供商或归档用户的任何更改已创建。这样可以确保其他人可以看到这些更改即将运行的活动。你可能会想要承诺您的数据在关键时间更具攻击性活动的生命周期:例如,在开始新的活动,在完成自己的活动之前,当用户在输入字段之间切换等。

此模型旨在防止用户导航时数据丢失活动之间,并允许系统安全地终止活动(因为在其他地方需要系统资源)已暂停。注意这意味着用户在活动中按BACK时意思是“取消”——它意味着将活动保留为当前内容被救走了。取消活动中的编辑必须通过提供其他一些机制,例如显式的“revert”或“undo”选项。

请参阅内容包对于有关内容提供商的更多信息。这些是如何不同的活动在它们之间调用和传播数据。

Activity类还提供了一个用于管理内部持久状态的API与活动关联。例如,这可以用于记忆用户在日历中首选的初始显示(日视图或周视图)或用户在web浏览器中的默认主页。

活动持续状态被管理用这个方法getPreferences(int),允许您检索和修改与活动关联的一组名称/值对。要使用跨多个应用程序组件共享的首选项(活动、接收者、服务、提供者),您可以使用上下文.getSharedPreferences()方法检索首选项对象存储在特定名称下。(请注意,无法在应用程序之间共享设置数据包——为此,您需要一个内容提供商。)

下面是一个日历活动的摘录,其中存储了用户的持久设置中的首选视图模式:

公共类CalendarActivity扩展Activity{...静态最终int DAY_VIEW_MODE=0;静态最终int WEEK_VIEW_MODE=1;私有SharedPreferences mPrefs;私有int mCurViewMode;protected void onCreate(捆绑保存的实例状态){super.onCreate(savedInstanceState);SharedPreferences mPrefs=获取共享首选项();mCurViewMode=mPrefs.getInt(“视图模式”,DAY_view_mode);}受保护的void on Pause(){super.onPause();共享首选项。编辑器ed=mPrefs.edit();ed.putInt(“视图模式”,mCurViewMode);编辑委员会();}}

权限

启动特定活动的能力可以在在其中声明舱单<活动>标签。这样,其他应用程序将需要声明相应的<使用权限>元素,以便能够启动该活动。

启动“活动”时,可以设置意图。标志_授权_读取_权限和/或意图。标志_授权_写入_权限关于意图。这将授予对Intent中特定URI的活动访问。将保留访问权限直到活动完成(它将保留在整个宿主中过程被终止和其他临时破坏)。截至姜饼,如果活动已创建,正在向发送新意向onNewIntent(意向),将添加任何新授予的URI权限它持有的现有股票。

请参阅安全和权限有关权限和一般安全性的更多信息,请参阅文档。

整个生命周期

Android系统试图将应用程序进程保持为尽可能长,但最终需要在以下情况下删除旧进程内存不足。如中所述活动生命周期,关于删除哪个流程的决定是密切相关的与用户与其交互的状态相关根据流程中运行的活动,流程可以处于四种状态,此处按重要性列出。系统将杀死不太重要的人在它诉诸于杀死更重要的人之前的进程(最后一个)流程(第一个)。

  1. 这个前台活动(屏幕顶部的活动用户当前正在交互的)被认为是最重要的。如果它使用更多的内存,那么它的进程只有在万不得已时才会被终止设备上可用的。通常在这一点上,设备具有达到内存分页状态,因此这是为了保持用户界面响应。

  2. A类可见放射性(用户可见的活动但不在前台,例如坐在前台对话框后面的)被认为是极其重要的,除非是保持前台活动运行所必需的。

  3. A类背景放射性(不可见的活动用户和已暂停)不再重要,因此系统可能安全地终止其进程以回收其他前台或可见流程。如果需要终止其进程,则当用户导航时回到活动(使其再次显示在屏幕上)onCreate(捆绑包)方法将使用之前的savedInstanceState调用在中提供onSaveInstanceState(捆绑包)这样它就可以重新启动用户上次离开时的状态。

  4. 空进程是没有活动还是其他应用程序组件(例如服务广播接收机类)。这些人死得很惨当内存变低时,系统会迅速将其删除。因此,任何在活动外部执行的后台操作必须在BroadcastReceiver或Service活动的上下文,以确保系统知道需要保持流程畅通。

有时,“活动”可能需要执行存在的长时间运行的操作独立于活动生命周期本身。相机就是一个例子允许您将图片上传到网站的应用程序。上传可能需要很长时间,应用程序应该允许用户离开应用程序将执行它。为了实现这一点,您的活动应该启动服务在其中进行上传。这允许系统正确划分流程的优先级(考虑到优先级更高比其他不可见应用程序重要)上传,与原始活动是否暂停、停止无关,或已完成。

总结

常量
整数 默认_KEYS_DIALER 与一起使用setDefaultKeyMode(int)在默认情况下启动拨号程序密钥处理。
整数 默认键禁用 与一起使用setDefaultKeyMode(int)关闭的默认处理按键。
整数 默认_KEYS_SEARCH_GLOBAL 与一起使用setDefaultKeyMode(int)指定未处理的击键将启动全局搜索(通常是网络搜索,但某些平台可能会定义替代搜索全局搜索的方法)

请参见android应用程序。浮动搜索框了解更多详细信息。

整数 默认_KEYS_SEARCH_LOCAL 与一起使用setDefaultKeyMode(int)指定未处理的击键将启动应用程序定义的搜索。
整数 默认_按键_截图 与一起使用setDefaultKeyMode(int)在中执行菜单快捷方式默认密钥处理。
整数 结果_取消 标准活动结果:操作已取消。
整数 结果_FIRST_USER 用户定义的活动结果的开始。
整数 结果_确定 标准活动结果:操作成功。
[展开]
继承的常量
来自班级android内容。上下文
来自接口android内容。组件回调2
领域
受保护的静止的最终的整数[] 聚焦_状态_设置
公共建筑商
活动()
公共方法
空隙 添加内容视图(查看视图,查看组。布局参数参数)
向活动添加其他内容视图。
空隙 关闭上下文菜单()
以编程方式关闭最近打开的上下文菜单(如果显示)。
空隙 关闭选项菜单()
按程序关闭选项菜单。
处理意图 创建结束结果(int请求代码,意图数据,int标志)
创建一个新的PendingIntent对象,您可以将其交给其他人用于将结果数据发送回您的onActivityResult(int,int,Intent)回调。
最终的空隙 解除对话框(内部id)
此方法已弃用API等级13。使用新的对话框片段与一起上课碎片管理器相反;这也是可通过Android兼容性包在较旧的平台上使用。
布尔值 调度GenericMotionEvent(MotionEvent(运动事件)电动汽车)
调用以处理一般运动事件。
布尔值 dispatchKeyEvent(分派关键事件)(键盘事件事件)
调用以处理关键事件。
布尔值 dispatchKeyShortcut事件(键盘事件事件)
调用以处理快捷键事件。
布尔值 调度PopulateAccess事件(辅助功能事件事件)
调用以处理的填充辅助功能事件第条。
布尔值 调度TouchEvent(MotionEvent(运动事件)电动汽车)
调用以处理触摸屏事件。
布尔值 dispatchTrackballEvent(调度跟踪球事件)(MotionEvent(运动事件)电动汽车)
调用以处理轨迹球事件。
空隙 倾倒(字符串前缀,文件描述符fd、,字符打印流作者,字符串[]参数)
将“活动”的状态打印到给定流中。
查看 按Id查找视图(内部id)
从XML中查找由id属性标识的视图在中处理onCreate(捆绑包).
空隙 完成()
当您的活动完成并应该结束时,请拨打此电话。
空隙 完成活动(int请求代码)
强制完成之前开始的另一项活动startActivityForResult(意向,int).
空隙 从子项完成活动(活动child,int requestCode)
当此活动的子活动调用其finishActivity()。
空隙 完成亲和力()
完成此活动及其下的所有活动在具有相同关联性的当前任务中。
空隙 从子级完成(活动儿童)
当此活动的子活动调用其完成()方法。
操作栏 获取操作栏()
检索对此活动的ActionBar的引用。
最终的应用程序 获取应用程序()
返回拥有此活动的应用程序。
组件名称 获取调用活动()
返回调用此活动的活动的名称。
字符串 获取调用包()
返回调用此活动的包的名称。
整数 获取更改配置()
如果此活动因无法处理配置参数被更改(因此其onConfigurationChanged(配置)方法是被调用),则可以使用此方法来发现存在过程中发生的一组变化摧毁。
组件名称 获取组件名称()
返回此活动的完整组件名称。
查看 获取当前焦点()
电话获取当前焦点()此“活动”的窗口,以返回当前聚焦的视图。
碎片管理器 获取片段管理器()
返回FragmentManager以与关联的片段进行交互进行此活动。
意图 获取意向()
返回启动此活动的意图。
对象 获取最后一个非配置实例()
此方法已弃用API等级13。使用新的碎片美国石油学会setRetainInstance(布尔值)相反;这也是通过Android兼容包在旧平台上提供。
布局填充器 获取布局充气器()
装载机管理器 获取加载器管理器()
返回此片段的LoaderManager,并在需要时创建它。
字符串 获取本地类名()
返回删除了包前缀的此活动的类名。
菜单充气器 获取菜单充气器()
返回一个菜单充气器在这种背景下。
最终的活动 获取父级()
如果此视图是嵌入的子视图,则返回父活动。
意图 获取家长活动意向()
获取意图将启动由指定的显式目标活动此活动的逻辑父级。
共享首选项 获取首选项(int模式)
检索共享首选项用于访问首选项的对象这是本次活动的隐私。
整数 获取请求的方向()
返回活动的当前请求方向。
对象 获取系统服务(字符串名称)
按名称返回系统级服务的句柄。
整数 获取任务ID()
返回此活动所在任务的标识符。
最终的字符序列 获取标题()
最终的整数 获取标题颜色()
最终的整数 获取卷控制流()
获取建议的音频流,其音量应由harwdare音量控制。
窗口 获取窗口()
检索当前窗口用于活动。
窗口管理器 获取窗口管理器()
检索窗口管理器以显示自定义窗口。
布尔值 hasWindowFocus(窗口焦点)()
如果此活动的主要的窗口当前具有窗口焦点。
空隙 无效选项菜单()
声明选项菜单已更改,因此应重新创建。
布尔值 正在更改配置()
检查此活动是否正在销毁过程中,以便使用新配置重新创建。
最终的布尔值 是Child()
此活动是否嵌入到另一个活动中?
布尔值 已销毁()
如果最终值为onDestroy()已拨打电话因此此实例现在已死亡。
布尔值 正在完成()
检查此活动是否正在完成过程中,要么是因为你打过电话完成()或者其他人已请求完成。
布尔值 是沉浸式的()
指示此活动“沉浸式”且不应如果可能,会被通知中断。
布尔值 isTaskRoot(任务根)()
返回此活动是否为任务的根。
最终的光标 受管理的查询(乌里uri,字符串[]投影,字符串选择,字符串[]选择参数,字符串排序顺序)
此方法已弃用API级别11。使用游标加载器相反。
布尔值 将任务向后移动(布尔值非根)
将包含此活动的任务移到活动的后面堆栈。
布尔值 导航上至(意图upIntent)
从该活动导航到upIntent指定的活动,完成该活动在这个过程中。
布尔值 从子级导航到上一级(活动孩子,意图upIntent)
当此活动的子活动调用其navigateUpTo(目的)方法。
空隙 on操作模式已完成(操作模式模式)
通知活动操作模式已完成。
空隙 onActionMode已启动(操作模式模式)
通知“活动”操作模式已启动。
空隙 在附加片段上(碎片碎片)
当碎片附加到此活动时立即调用在调用它之后片段.onAttach()方法和之前片段.onCreate().
空隙 在附加到窗口上()
当与活动关联的主窗口附加到窗口管理器。
空隙 按反键()
当活动检测到用户按下背部时调用键。
空隙 onConfigurationChanged(配置已更改)(配置新配置)
当您的活动正在运行。
空隙 onContentChanged(内容已更改)()
每当屏幕的内容视图更改时,都会调用此挂钩(由于打电话给窗口.设置内容视图窗口添加内容视图).
布尔值 已选择onContextItem(菜单项项目)
每当选中上下文菜单中的项时,就会调用此挂钩。
空隙 onContextMenu关闭(菜单菜单)
每当上下文菜单被关闭时(通过用户使用back/menu按钮取消菜单,或者当项目选中)。
空隙 onCreateContextMenu(创建上下文菜单)(上下文菜单菜单,查看v、,上下文菜单。上下文菜单信息菜单信息)
当上下文菜单看法即将放映。
字符序列 onCreateDescription(创建描述)()
生成此活动的新描述。
空隙 onCreateNavigateUpTaskStack(任务堆栈生成器建筑商)
定义将在向上导航期间从生成的合成任务堆栈不同的任务。
布尔值 onCreateOptions菜单(菜单菜单)
初始化“活动”标准选项菜单的内容。
布尔值 在CreatePanel菜单上(int featureId,菜单菜单)
的默认实现onCreatePanelMenu(int,菜单)用于活动。
查看 在CreatePanelView上(int featureId)
的默认实现onCreatePanelView(int)用于活动。
布尔值 在创建缩略图时(位图输出位图,帆布帆布)
为此活动生成新缩略图。
查看 在CreateView上(查看起源,字符串名称,上下文上下文,属性集属性)
标准实施onCreateView(视图、字符串、上下文、属性集)使用返回的LayoutInflator进行充气时使用getSystemService(字符串).
查看 在CreateView上(字符串名称,上下文上下文,属性集属性)
标准实施onCreateView(字符串、上下文、属性集)在以下情况下使用使用返回的LayoutInflator进行充气getSystemService(字符串).
空隙 onDetachedFrom窗口()
当与活动关联的主窗口与窗口管理器分离。
布尔值 关于GenericMotionEvent(MotionEvent(运动事件)事件)
当任何活动内部的视图。
布尔值 onKeyDown(按向下键)(int keyCode,键盘事件事件)
当按键被按下且未被任何视图处理时调用活动内部。
布尔值 onKeyLongPress上(int keyCode,键盘事件事件)
的默认实现KeyEvent。回调.onKeyLongPress():始终返回false(不处理事件)。
布尔值 onKeyMultiple(int keyCode,int repeatCount,键盘事件事件)
的默认实现KeyEvent。回调.onKeyMultiple():始终返回false(不处理事件)。
布尔值 onKeyShortcut(按键快捷方式)(int keyCode,键盘事件事件)
当“活动”中的任何视图都未处理键快捷方式事件时调用。
布尔值 on键向上(int keyCode,键盘事件事件)
当密钥被释放且未被任何视图处理时调用活动内部。
空隙 在低内存上()
这是在整个系统内存不足时调用的,并且主动运行的进程应该减少内存使用。
布尔值 已选择菜单项(int featureId,菜单项项目)
的默认实现onMenuItemSelected(int,MenuItem)用于活动。
布尔值 打开菜单时(int featureId,菜单菜单)
当用户打开面板菜单时调用。
布尔值 onNavigateUp(导航上)()
每当用户选择在应用程序的操作栏中的活动层次结构。
布尔值 从子级向上导航(活动儿童)
当此活动的子活动尝试向上导航时,将调用此函数。
布尔值 所选选项项目(菜单项项目)
只要选择了选项菜单中的项目,就会调用此挂钩。
空隙 onOptions菜单关闭(菜单菜单)
每当选项菜单被关闭时(用户取消带有back/menu按钮的菜单,或选择项目时的菜单)。
空隙 面板关闭时(int featureId,菜单菜单)
的默认实现onPanelClosed(int,菜单)对于活动。
空隙 onPrepareNavigateUpTaskStack(任务堆栈生成器建筑商)
准备将在向上导航期间生成的合成任务堆栈来自不同的任务。
布尔值 onPrepareOptions菜单(菜单菜单)
准备要显示的屏幕标准选项菜单。
布尔值 onPreparePanel(准备面板)(int featureId,查看视图,菜单菜单)
的默认实现onPreparePanel(int、View、Menu)用于活动。
空隙 提供辅助数据(捆绑数据)
当用户请求帮助时调用此函数,以构建完整的动作_助理意图与当前的所有上下文应用程序。
对象 onRetainNonConfigurationInstance()
此方法已弃用API等级13。使用新的碎片美国石油学会setRetainInstance(布尔值)相反;这也是可通过Android兼容性包在较旧的平台上使用。
布尔值 请求的搜索()
当用户发出开始搜索的信号时,将调用此钩子。
布尔值 onTouch活动(MotionEvent(运动事件)事件)
当任何视图未处理触摸屏事件时调用在它下面。
布尔值 onTrackball活动(MotionEvent(运动事件)事件)
当轨迹球被移动且未被任何活动内部的视图。
空隙 onTrimMemory(调整内存)(int级)
当操作系统确定它是好的时调用进程从其进程中删除不需要的内存的时间。
空隙 onUserInteraction(用户交互)()
每当向发送按键、触摸或轨迹球事件时调用活动。
空隙 窗口属性已更改(窗口管理器。布局参数参数)
只要当前窗口属性更改,就会调用此函数。
空隙 onWindows焦点已更改(布尔型hasFocus)
当当前窗口活动的得失集中。
操作模式 onWindows启动操作模式(ActionMode(操作模式)。回拨回调)
让“活动”有机会控制请求的操作模式的UI由系统决定。
空隙 打开上下文菜单(查看视图)
以编程方式打开特定看法.
空隙 打开选项菜单()
以编程方式打开选项菜单。
空隙 覆盖挂起的转换(int enterAnim,int exitAnim)
在品尝完其中一种口味后立即致电startActivity(目的)完成()将显式过渡动画指定给执行下一步。
空隙 重新创建()
使用新实例重新创建此“活动”。
空隙 注册表用于上下文菜单(查看视图)
注册要为给定视图显示的上下文菜单(多个视图可以显示上下文菜单)。
最终的空隙 删除对话框(int id)
此方法已弃用API等级13。使用新的对话框片段与一起上课碎片管理器相反;这也是可通过Android兼容性包在较旧的平台上使用。
空隙 报告完全提取()
向系统报告您的应用程序现在已完全绘制,仅用于诊断目的(调用它不会影响活动的可见行为)。
最终的布尔值 请求窗口功能(int featureId)
启用扩展窗口功能。
最终的空隙 运行OnUiThread(可跑步动作)
在UI线程上运行指定的操作。
空隙 设置内容视图(int layoutResID)
从版面资源设置活动内容。
空隙 设置内容视图(查看视图)
将活动内容设置为显式视图。
空隙 设置内容视图(查看视图,查看组。布局参数参数)
将活动内容设置为显式视图。
最终的空隙 设置默认键模式(int模式)
选择此活动的默认密钥处理。
最终的空隙 setFeatureDrawable(设置功能可绘制)(int featureId,可提取可抽出)
最终的空隙 setFeatureDrawableAlpha(int featureId,int alpha)
最终的空隙 setFeatureDrawableResource(设置功能可拖动资源)(int featureId,int resId)
最终的空隙 setFeatureDrawableUri(int featureId,乌里uri)
空隙 设置触摸外部完成时间(布尔完成)
设置在其窗口外触摸此活动时是否完成边界。
空隙 设置沉浸式(布尔值i)
调整当前沉浸式模式设置。
空隙 setIntent(设置意图)(意图newIntent)
更改返回的意图getIntent().
最终的空隙 设置进度(int进度)
设置标题中进度条的进度。
最终的空隙 设置进度条不确定(布尔不定)
设置标题中的水平进度条是否不确定(圆形总是不确定的)。
最终的空隙 设置进度条索引可见性(布尔可见)
设置标题中不确定进度条的可见性。
最终的空隙 设置进度条可见性(布尔可见)
设置标题中进度条的可见性。
空隙 设置请求的方向(int请求定向)
更改此活动的所需方向。
最终的空隙 设置结果(int resultCode)
调用此函数以设置您的活动将返回到其呼叫方。
最终的空隙 setResult(设置结果)(int结果代码,意图数据)
调用此函数以设置您的活动将返回到其呼叫方。
最终的空隙 设置次要进度(int secondaryProgress)
设置标题中进度条的次要进度。
空隙 设置标题(int titleId)
更改与此活动关联的标题。
空隙 集合标题(字符序列标题)
更改与此活动关联的标题。
空隙 设置标题颜色(int textColor)
空隙 设置可见(布尔可见)
控制此活动的主窗口是否可见。
最终的空隙 音频流(int streamType)
建议硬件应更改其音量的音频流音量控制。
布尔值 应该向上重新创建任务(意图目标意图)
如果应用程序在从该活动“向上”导航时应重新创建任务,则返回true使用targetIntent。
最终的布尔值 显示对话框(int id,捆绑参数)
此方法已弃用API等级13。使用新的对话框片段与一起上课碎片管理器相反;这也是可通过Android兼容性包在较旧的平台上使用。
最终的空隙 显示对话框(int id)
此方法已弃用API等级13。使用新的对话框片段与一起上课碎片管理器相反;这也是可通过Android兼容性包在较旧的平台上使用。
操作模式 启动操作模式(ActionMode(操作模式)。回拨回调)
启动操作模式。
空隙 启动活动(意向[]意图,捆绑选项)
启动新活动。
空隙 启动活动(意向[]意图)
等同于startActivities(意向[],捆绑)没有选项明确规定。
空隙 启动活动(意图意图)
等同于startActivity(意向、捆绑)没有选项明确规定。
空隙 启动活动(意图意图,捆绑选项)
启动新活动。
空隙 启动结果活动(意图intent,int requestCode)
空隙 启动结果活动(意图intent,int请求代码,捆绑选项)
启动一项活动,您希望在活动结束时获得结果。
空隙 从子项启动活动(活动儿童,意图intent,int请求代码,捆绑选项)
当此活动的子活动调用其startActivity(目的)startActivityForResult(意向,int)方法。
空隙 从子项启动活动(活动孩子,意图intent,int requestCode)
空隙 从片段开始活动(碎片碎片,意图intent,int请求代码,捆绑选项)
当此活动中的片段调用其startActivity(目的)startActivityForResult(意向,int)方法。
空隙 从片段开始活动(碎片碎片,意图intent,int requestCode)
布尔值 启动活动(如果需要)(意图intent,int请求代码,捆绑选项)
仅在新活动时启动活动的特殊变体实例来处理给定的Intent。
布尔值 启动活动(如果需要)(意图intent,int requestCode)
空隙 startIntent发送器(意向发送方意图,意图fillInIntent,int标志掩码,int标志值,int extraFlags,捆绑选项)
空隙 startIntent发送器(意向发送方意图,意图fillInIntent,int flagsMask,int flagesValues,int extraFlags)
空隙 startIntentSenderForResult启动意向发送器(意向发送方intent,int请求代码,意图fillInIntent,int flagsMask,int flagsValues,int extraFlags,捆绑选项)
喜欢startActivityForResult(意向,int),但允许你使用IntentSender描述要启动的活动。
空隙 startIntentSenderForResult启动意向发送器(意向发送方intent,int请求代码,意图fillInIntent,int flagsMask,int flagesValues,int extraFlags)
空隙 startIntentSenderFromChild(活动儿童,意向发送方intent,int请求代码,意图fillInIntent,int flagsMask,int flagesValues,int extraFlags)
空隙 startIntentSenderFromChild(活动孩子,意向发送方intent,int请求代码,意图fillInIntent,int标志掩码,int标志值,int extraFlags,捆绑选项)
空隙 启动管理光标(光标c)
此方法已弃用API级别11。使用新的游标加载器与一起上课装载机管理器相反;这也是可通过Android兼容性包在较旧的平台上使用。
布尔值 启动下一个匹配活动(意图意图)
与呼叫相同startNextMatchingActivity(意向、捆绑)具有没有选项。
布尔值 启动下一个匹配活动(意图意图,捆绑选项)
启动活动的特殊版本,用于更换其他活动组件。
空隙 启动搜索(字符串initialQuery,布尔选择initialQuery,捆绑appSearchData,布尔全局搜索)
调用此挂钩以启动搜索UI。
空隙 停止管理光标(光标c)
此方法已弃用API级别11。使用新的游标加载器与一起上课装载机管理器相反;这也是可通过Android兼容性包在较旧的平台上使用。
空隙 takeKeyEvents(获取键事件)(布尔get)
要求关键事件参与此活动。
空隙 触发器搜索(字符串查询,捆绑应用搜索数据)
类似startSearch(字符串、布尔值、束、布尔值),但实际上在调用后触发搜索查询搜索对话框。
空隙 取消注册ContextMenu(查看视图)
防止为给定视图显示关联菜单。
受保护的方法
空隙 onActivityResult(活动结果)(int请求代码,int结果代码,意图数据)
当您启动的活动退出时调用,为您提供requestCode开始时使用、返回的resultCode以及任何其他数据。
空隙 应用主题资源(资源。主题主题,int resi,布尔优先)
由调用集合主题(int)获取主题()应用主题资源添加到当前主题对象。
空隙 onChildTitleChanged(活动子活动,字符序列标题)
空隙 创建时的回调函数(捆绑savedInstanceState)
在活动启动时调用。
对话框 on创建对话框(int id)
此方法已弃用API级别8。旧的无参数版本onCreateDialog(int,捆绑).
对话框 在CreateDialog上(int id,捆绑参数)
此方法已弃用API等级13。使用新的对话框片段与一起上课碎片管理器相反;这也是通过Android兼容包在旧平台上提供。
空隙 销毁()
在销毁活动之前执行任何最终清理。
空隙 关于NewIntent(意图意图)
这是为在中将launchMode设置为“singleTop”的活动调用的或者如果客户端使用FLAG_ACTIVITY_SINGLE_TOP标志呼叫时标记startActivity(目的).
空隙 onPause(暂停)()
当活动进入时,作为活动生命周期的一部分调用背景,但尚未被杀死。
空隙 在创建后(捆绑savedInstanceState)
活动启动完成时调用(之后启动()onRestoreInstanceState(捆绑包)已被调用)。
空隙 在PostResume上()
活动恢复完成时调用(之后onResume()已调用)。
空隙 onPrepare对话框(int id,对话框对话框)
此方法已弃用API级别8。旧的无参数版本onPrepareDialog(int、Dialog、Bundle).
空隙 onPrepare对话框(int id,对话框对话框,捆绑参数)
此方法已弃用API等级13。使用新的对话框片段与一起上课碎片管理器相反;这也是可通过Android兼容性包在较旧的平台上使用。
空隙 重新启动时()
在之后调用onStop()当前活动正在进行时重新显示给用户(用户已经导航回它)。
空隙 onRestoreInstanceState(捆绑savedInstanceState)
此方法在之后调用启动()当活动是从先前保存的状态重新初始化,如下所示倚仗.
空隙 onResume(继续)()
在之后调用onRestoreInstanceState(捆绑包),重新启动(),或onPause(),以便您的活动开始与用户交互。
空隙 onSaveInstanceState(捆绑outState)
调用以在终止之前从活动中检索per-instance状态这样就可以恢复状态onCreate(捆绑包)onRestoreInstanceState(捆绑包)(该捆绑通过此方法填充将传递给两者)。
空隙 启动时()
在之后调用onCreate(捆绑包)-或之后重新启动()何时活动已停止,但现在再次显示给用户。
空隙 on停止()
当用户不再看到您时调用。
空隙 onTitleChanged(标题已更改)(字符序列标题,int颜色)
空隙 onUserLeaveHint(用户离开提示)()
当活动即将开始时,作为活动生命周期的一部分调用成为用户选择的结果。
[展开]
继承的方法
来自班级android.view。上下文主题包装器
来自班级android内容。上下文包装器
来自班级android内容。上下文
来自班级java.lang.Object(java.lang.对象)
来自接口android内容。组件回调
来自接口android内容。组件回调2
来自接口android.view。KeyEvent。回拨
来自接口android.view。布局充气器。工厂
来自接口android.view。布局充气器。因子2
来自接口android.view。查看。OnCreateContextMenuListener
来自接口android.view。窗口。回拨

常量

公众静态最终整数默认密钥分配器

已在中添加API级别1

与一起使用setDefaultKeyMode(int)在默认情况下启动拨号程序密钥处理。

常量值: 1(0x00000001)

公众静态最终整数默认键禁用

已在中添加API级别1

与一起使用setDefaultKeyMode(int)关闭的默认处理按键。

常量值: 0(0x00000000)

公众静态最终整数默认_KEYS_SEARCH_GLOBAL

已在中添加API级别1

与一起使用setDefaultKeyMode(int)指定未处理的击键将启动全局搜索(通常是网络搜索,但某些平台可能会定义替代搜索全局搜索的方法)

请参见android应用程序。浮动搜索框了解更多详细信息。

常量值: 4(0x00000004)

公众静态最终整数默认_KEYS_SEARCH_LOCAL

已在中添加API级别1

与一起使用setDefaultKeyMode(int)指定未处理的击键将启动应用程序定义的搜索。(如果应用程序或活动没有实际上定义了一个搜索,这些键将被忽略。)

请参见android应用程序。浮动搜索框了解更多详细信息。

常量值: (0x00000003)

公众静态最终整数默认_按键_截图

已在中添加API级别1

与一起使用setDefaultKeyMode(int)在中执行菜单快捷方式默认密钥处理。

也就是说,用户无需按住菜单键即可执行菜单快捷方式。

常量值: 2(0x00000002)

公众静态最终整数结果_取消

已在中添加API级别1

标准活动结果:操作已取消。

常量值: 0(0x00000000)

公众静态最终整数结果_FIRST_USER

已在中添加API级别1

用户定义的活动结果的开始。

常量值: 1(0x00000001)

公众静态最终整数结果_确定

已在中添加API级别1

标准活动结果:操作成功。

常量值: -1(0xffffff)

领域

受保护的静态最终整数[]聚焦_状态_设置

已在中添加API级别1

公共建筑商

公众的 活动 ()

已在中添加API级别1

公共方法

公众空隙 添加内容视图 (查看视图,查看组。布局参数参数)

已在中添加API级别1

向活动添加其他内容视图。在任何现有的之后添加活动中的视图--不会删除现有视图。

参数
看法 要显示的所需内容。
参数 视图的布局参数。

公众空隙 关闭上下文菜单 ()

已在中添加API级别3

以编程方式关闭最近打开的上下文菜单(如果显示)。

公众空隙 关闭选项菜单 ()

已在中添加API级别1

按程序关闭选项菜单。如果选项菜单已经存在关闭时,此方法不执行任何操作。

公众的处理意图 创建挂起结果 (int请求代码,意图数据,int标志)

已在中添加API级别1

创建一个新的PendingIntent对象,您可以将其交给其他人用于将结果数据发送回您的onActivityResult(int,int,Intent)回调。创建的对象将是单发(结果发回后无效)或多发(允许通过它发送任意数量的结果)。

参数
请求代码 发件人的私人请求代码返回时与结果数据关联。发件人不能修改此值,使您能够识别传入的结果。
数据 结果中提供的默认数据,可以修改由发送方提供。
旗帜 可能是待定意向。FLAG_ONE_SHOT标记,待定意向。标志_创建,待定意向。标志_取消_电流,待定意向。标志更新当前,或支持的任何标志Intent.fillIn()控制哪些未指定零件实际发送时可以提供的意图。
退换商品
另请参阅

公众最终空隙 解除对话框 (int id)

已在中添加API级别1

此方法已弃用API等级13。
使用新的对话框片段与一起上课碎片管理器相反;这也是可通过Android兼容性包在较旧的平台上使用。

关闭以前通过显示的对话框showDialog(int).

参数
身份证件 托管对话框的id。
投掷
非法数据异常 如果之前未通过显示idshowDialog(int).

公众布尔值 调度GenericMotionEvent (MotionEvent(运动事件)电动汽车)

已在中添加API级别12

调用以处理一般运动事件。您可以将其覆盖为在将所有通用运动事件发送到窗口。确保为通用运动事件调用此实现应该正常处理。

参数
电动汽车 通用运动事件。
退换商品
  • boolean如果使用了此事件,则返回true。

公众布尔值 dispatchKeyEvent(分派关键事件) (键盘事件事件)

已在中添加API级别1

调用以处理关键事件。你可以覆盖它来拦截所有关键事件,然后将其发送到窗口。一定要打电话此实现用于应该正常处理的关键事件。

参数
事件 关键事件。
退换商品
  • boolean如果使用了此事件,则返回true。

公众布尔值 dispatchKeyShortcut事件 (键盘事件事件)

已在中添加API级别11

调用以处理键快捷方式事件。您可以覆盖此选项,以便在发生关键快捷方式事件之前拦截这些事件发送到窗口。确保调用此实现以获取快捷键应该正常处理的事件。

参数
事件 快捷键事件。
退换商品
  • 如果使用了此事件,则为True。

公众布尔值 调度PopulateAccess事件 (辅助功能事件事件)

调用以处理的填充可访问性事件第条。

参数
事件 事件。
退换商品
  • boolean如果事件填充完成,则返回true。

公众布尔值 调度TouchEvent (MotionEvent(运动事件)电动汽车)

已在中添加API级别1

调用以处理触摸屏事件。您可以将其覆盖为在将所有触摸屏事件发送到窗口。确保为触摸屏事件调用此实现应该正常处理。

参数
电动汽车 触摸屏事件。
退换商品
  • boolean如果使用了此事件,则返回true。

公众布尔值 dispatchTrackball事件 (MotionEvent(运动事件)电动汽车)

已在中添加API级别1

调用以处理轨迹球事件。您可以将其覆盖为拦截所有轨迹球事件,然后将其发送到窗口。确保为轨迹球事件调用此实现应该正常处理。

参数
电动汽车 轨迹球事件。
退换商品
  • boolean如果使用了此事件,则返回true。

公众空隙 倾倒 (字符串前缀,文件描述符fd、,字符打印流作者,字符串[]参数)

已在中添加API级别11

将“活动”的状态打印到给定流中。如果您可以运行“adb shell dumpsys activity<activity组件名称>”。

参数
前缀 在输出的每一行预先插入所需的前缀。
频差 转储发送到的原始文件描述符。
作家 您应该将状态转储到的PrintWriter。这将是你回来后就关门了。
参数 转储请求的其他参数。

公众的查看 按Id查找视图 (int id)

已在中添加API级别1

从XML中查找由id属性标识的视图在中处理onCreate(捆绑包).

退换商品
  • 如果找到视图,则为空。

公众空隙 完成 ()

已在中添加API级别1

当您的活动完成并应该结束时,请拨打此电话。这个ActivityResult会传回给通过其启动您的人onActivityResult()。

公众空隙 完成活动 (int请求代码)

已在中添加API级别1

强制完成之前开始的另一项活动startActivityForResult(意向,int).

参数
请求代码 您拥有的活动的请求代码提供给startActivityForResult()。如果有多个活动从这个请求代码开始将全部完成。

公众空隙 从子项完成活动 (活动child,int requestCode)

已在中添加API级别1

当此活动的子活动调用其finishActivity()。

参数
小孩 拨打电话的活动。
请求代码 用于启动的请求代码活动。

公众空隙 完成亲和力 ()

已在中添加API级别16

完成此活动及其下的所有活动在具有相同关联性的当前任务中。这通常是当应用程序可以启动到另一个任务(例如从它理解的内容类型的ACTION_VIEW)和用户已使用向上导航切换出当前任务并进入完成自己的任务。在这种情况下,如果用户向下导航到第二个应用程序的任何其他活动,所有这些活动都应该作为任务切换的一部分从原始任务中删除。

请注意,此饰面可以让您交付结果到上一个活动,如果您尝试这样做。

公众空隙 从子级完成 (活动儿童)

已在中添加API级别1

当此活动的子活动调用其完成()方法。默认实现只调用finish(),完成整个组。

参数
小孩 拨打电话的活动。
另请参阅

公众的操作栏 获取操作栏 ()

已在中添加API级别11

检索对此活动的ActionBar的引用。

退换商品
  • Activity的ActionBar,如果没有Action Bar,则为null。

公众最终的应用程序 获取应用程序 ()

已在中添加API级别1

返回拥有此活动的应用程序。

公众的组件名称 获取调用活动 ()

已在中添加API级别1

返回调用此活动的活动的名称。这是数据输入者setResult()将发送到。您可以使用此信息验证是否允许收件人接收数据。

注意:如果调用活动不期望结果(就是这样没有使用startActivityForResult(意向,int)表单中包含请求代码),则调用包将是无效的。

退换商品
  • 将接收您的回复,如果没有,则返回null。

公众的字符串 获取调用包 ()

已在中添加API级别1

返回调用此活动的包的名称。这就是谁中的数据setResult()将发送到。您可以使用此信息验证是否允许收件人接收数据。

注意:如果调用活动不期望结果(就是这样没有使用startActivityForResult(意向,int)表单中包含请求代码),则调用包将是无效的。

注:之前珠宝_BEAN_MR2,这种方法的结果是不稳定的。如果承载调用的进程包不再运行,它将返回null而不是正确的包名称。你可以使用获取调用活动()并检索包名称取而代之的是。

退换商品
  • 将收到您的回复,如果没有,则返回null。

公众整数 获取更改配置 ()

已在中添加API级别1

如果此活动因无法处理配置参数被更改(因此其onConfigurationChanged(配置)方法是被调用),然后您可以使用此方法来发现存在过程中发生的一组变化摧毁。请注意,不能保证这些准确(可能随时发生其他更改),因此您应该仅将其用作优化提示。

退货
  • 返回配置参数的位字段根据配置类。

公众的组件名称 获取组件名称 ()

已在中添加API级别1

返回此活动的完整组件名称。

退换商品
  • 返回此活动的完整组件名称

公众的查看 获取当前焦点 ()

已在中添加API级别1

电话获取当前焦点()此“活动”窗口返回当前聚焦的视图。

退换商品
  • 查看具有焦点或null的当前视图。

公众的碎片管理器 获取片段管理器 ()

已在中添加API级别11

返回FragmentManager以与关联的片段进行交互进行此活动。

公众的意图 获取意向 ()

已在中添加API级别1

返回启动此活动的意图。

公众的对象 getLastNonConfiguration实例 ()

已在中添加API级别1

此方法已弃用API等级13。
使用新的碎片美国石油学会setRetainInstance(布尔值)相反;这也是可通过Android兼容性包在较旧的平台上使用。

检索以前的非配置实例数据由返回onRetainNonConfigurationInstance()。这将从一开始就可以使用onCreate(捆绑包)启动()调用新实例,允许您提取来自上一个实例的任何有用的动态状态。

请注意,您在此处检索的数据应该只有被使用作为处理配置更改的优化。你应该永远能够处理返回空指针的操作,并且活动必须仍然能够将自身恢复到以前的状态(通过正常的onSaveInstanceState(捆绑包)机制),即使这样函数返回null。

退换商品

公众的布局填充器 获取布局充气器 ()

已在中添加API级别1

公众的装载机管理器 获取装载机管理器 ()

已在中添加API级别11

返回此片段的LoaderManager,并在需要时创建它。

公众的字符串 获取本地类名 ()

已在中添加API级别1

返回删除了包前缀的此活动的类名。这是用于读取和写入设置的默认名称。

退换商品
  • 本地类名。

公众的菜单充气器 获取菜单充气器 ()

已在中添加API级别1

返回一个菜单充气器在这种背景下。

公众最终的活动 获取父级 ()

已在中添加API级别1

如果此视图是嵌入的子视图,则返回父活动。

公众的意图 获取家长活动意向 ()

已在中添加API级别16

获得意图将启动由指定的显式目标活动此活动的逻辑父级。逻辑父级在应用程序的清单中命名家长活动名称属性。活动子类可以重写此方法以修改super.getParentActivityIntent()或实现不同的检索机制完全符合父母的意图。

退换商品
  • 针对此活动的已定义父级的新Intent或null,如果没有有效的父项。

公众的共享首选项 获取首选项 (int模式)

已在中添加API级别1

检索共享首选项用于访问首选项的对象这是本次活动的隐私。这只是调用底层getSharedPreferences(字符串,int)通过传入此活动的类名作为首选项名称。

参数
模式 操作模式。使用模式_专用对于默认值操作,可阅读模式(WORLD READABLE)模式_世界_可写控制权限。
退换商品
  • 返回可以使用的单个SharedPreferences实例检索和修改首选项值。

公众整数 获取请求的方向 ()

已在中添加API级别1

返回活动的当前请求方向。这将要么是其组件清单中请求的方向,要么最后请求的方向setRequestedOrientation(int).

退换商品

公众的对象 获取系统服务 (字符串名称)

已在中添加API级别1

按名称返回系统级服务的句柄。The class of the返回的对象因请求的名称而异。当前可用名称是:

Windows服务(“窗口”)
可以在其中放置自定义的顶级窗口管理器窗户。返回的对象是窗口管理器.
布局_信息板_服务(“layout_inflater”)
A类布局填充器用于膨胀布局资源在这种情况下。
活动_维修(“活动”)
A类活动经理用于与系统的全局活动状态。
电源_服务(“电源”)
A类电源管理器用于控制电源管理层。
报警_维修(“警报”)
A类全局定时器接收意图你选择的时间。
通知_服务(“通知”)
A类通知管理器通知用户背景事件。
KEYGUARD_服务(“键盘锁”)
A类键盘管理器用于控制键盘锁。
位置_维修(“位置”)
A类位置管理器用于控制位置(例如GPS)更新。
搜索_服务(“搜索”)
A类浮动搜索框用于处理搜索。
振动器_维修(“振动器”)
A类振动器用于与可控震源交互硬件。
连接_服务(“连接”)
A类连接管理器对于处理网络连接的管理。
WIFI_服务(“wifi”)
A类Wifi管理器用于管理Wi-Fi连接。
输入方法服务(“输入法”)
输入方法管理器用于管理输入方法。
UI_模式_服务(“uimode”)
UiMode管理器用于控制UI模式。
下载_服务(“下载”)
A类下载管理器用于请求HTTP下载

注:通过此API获得的系统服务可能与获取它们的上下文。通常,不要共享不同上下文(活动、应用程序、,服务、提供商等)

参数
名称 所需服务的名称。
退换商品
  • 如果名称不存在,则返回服务或null。

公众整数 获取任务ID ()

已在中添加API级别1

返回此活动所在任务的标识符。此标识符在活动的生命周期内保持不变。

退换商品
  • 任务标识符,一个不透明的整数。

公众最终的字符序列 获取标题 ()

已在中添加API级别1

公众最终整数 获取标题颜色 ()

已在中添加API级别1

公众最终整数 获取卷控制流 ()

已在中添加API级别1

获取建议的音频流,其音量应由harwdare音量控制。

退换商品
  • 建议更改音量的音频流类型硬件音量控制。

公众的窗口 获取窗口 ()

已在中添加API级别1

检索当前窗口用于活动。这可用于直接访问Window API中不可通过活动/屏幕使用。

退换商品
  • 窗口当前窗口,如果活动不是视觉效果。

公众的窗口管理器 获取窗口管理器 ()

已在中添加API级别1

检索窗口管理器以显示自定义窗口。

公众布尔值 hasWindowFocus(窗口焦点) ()

已在中添加API级别3

如果此活动的主要的窗口当前具有窗口焦点。请注意,这与具有焦点的视图本身不同。

退换商品
  • 如果此活动的主窗口当前具有窗口焦点,则为True。

公众空隙 无效选项菜单 ()

已在中添加API级别11

声明选项菜单已更改,因此应重新创建。这个onCreateOptionsMenu(菜单)方法将被调用为next需要显示的时间。

公众布尔值 正在更改配置 ()

已在中添加API级别11

检查此活动是否正在销毁过程中,以便使用新配置重新创建。这通常用于onStop()以确定状态是否需要清理或将被传递通过转到活动的下一个实例onRetainNonConfigurationInstance().

退换商品
  • 如果要删除活动以使用新配置重新创建,返回true;否则返回false。

公众最终布尔值 是Child ()

已在中添加API级别1

此活动是否嵌入到另一个活动中?

公众布尔值 已销毁 ()

已在中添加API级别17

如果最终值为onDestroy()已拨打电话因此此实例现在已死亡。

公众布尔值 正在完成 ()

已在中添加API级别1

检查此活动是否正在完成过程中,要么是因为你打过电话完成()或者其他人已请求完成。这通常用于onPause()确定活动是否只是暂停或完全完成。

退换商品
  • 如果活动正在完成,则返回true;否则返回false。
另请参阅

公众布尔值 是沉浸式的 ()

已在中添加API等级18

指示此活动“沉浸式”且不应如果可能,会被通知中断。此值最初由清单属性设置安卓:身临其境但可以在运行时更改setImmersive(布尔).

公众布尔值 isTaskRoot(任务根) ()

已在中添加API级别1

返回此活动是否为任务的根。根是任务中的第一个活动。

退换商品
  • 如果这是根活动,则为True,否则为false。

公众最终的光标 受管理的查询 (乌里uri,字符串[]投影,字符串选择,字符串[]选择参数,字符串排序顺序)

已在中添加API级别1

此方法已弃用API级别11。
使用游标加载器相反。

包裹查询(android.net.Uri,String[],String,String[],字符串)从而得出结果光标打电话startManagingCursor(光标)以便活动管理其生命周期。如果你的目标是蜂巢或稍后,考虑使用装载机管理器相反,可用通过获取加载器管理器().

警告:不要打电话关闭()在使用获得的游标上这种方法,因为活动将在适当的时间为您完成这项工作。然而,如果你打电话来stopManagingCursor(光标)在托管查询的游标上,系统自动关闭光标,在这种情况下,必须调用关闭().

参数
uri(用户界面) 要查询的内容提供程序的URI。
投影 要返回的列的列表。
选择 SQL WHERE子句。
选择参数 选择的参数,如果有的话?s是pesent
sortOrder(排序顺序) SQL ORDER BY子句。
退换商品
  • query()返回的游标。

公众布尔值 将任务移回 (布尔非根)

已在中添加API级别1

将包含此活动的任务移到活动的后面堆栈。活动在任务中的顺序不变。

参数
非根 如果为false,则仅当活动是根时才有效任务;如果为true,则适用于中的任何活动一项任务。
退换商品
  • 如果任务已被移动(或已在back)返回true,否则返回false。

公众布尔值 导航上至 (意图upIntent)

已在中添加API级别16

从该活动导航到upIntent指定的活动,完成该活动在这个过程中。如果任务历史记录中已存在upIntent指示的活动,此活动和历史堆栈中指示的活动之前的所有其他活动将是已完成。

如果指示的活动未出现在历史堆栈中,则此操作将完成此任务中的每个活动,直到到达任务的根活动,从而“应用程序内主页”行为。这在具有复杂导航层次结构的应用程序中很有用当不通过规范父级的路径可以到达活动时活动。

当从同一任务中执行向上导航时,应使用此方法作为目的地。如果在某些情况下向上导航应该跨任务,请参阅应该重新创建任务(意图).

参数
upIntent(升级) 表示上行导航目标目的地的意图
退换商品
  • 如果向上导航成功到达upIntent指示的活动,则为true,并且upIntent已传递给它。如果指定活动的实例可以找不到,此活动只是正常完成。

公众布尔值 从子级导航到上一级 (活动孩子,意图upIntent)

已在中添加API级别16

当此活动的子活动调用其navigationUpTo(意向)方法。默认实现只调用navigateUpTo(upIntent)在此活动(父活动)上。

参数
小孩 拨打电话的活动。
upIntent(升级) 表示上行导航目标目的地的意图
退换商品
  • 如果向上导航成功到达upIntent和指示的活动,则为trueupIntent已传递给它。如果指定活动的实例可以找不到,此活动只是正常完成。

公众空隙 onActionMode已完成 (操作模式模式)

已在中添加API级别11

通知活动操作模式已完成。覆盖此方法的活动子类应调用超类实现。

参数
模式 刚刚完成的操作模式。

公众空隙 onActionMode已启动 (操作模式模式)

已在中添加API级别11

通知“活动”操作模式已启动。覆盖此方法的活动子类应调用超类实现。

参数
模式 新的操作模式。

公众空隙 在附加片段上 (碎片碎片)

已在中添加API级别11

当碎片附加到此活动时立即调用在调用它之后片段.onAttach()方法和之前片段.onCreate().

公众空隙 在附加到窗口上 ()

已在中添加API级别5

当与活动关联的主窗口附加到窗口管理器。请参见查看.onAttachedToWindow()了解更多信息。

公众空隙 按后退键 ()

已在中添加API级别5

当活动检测到用户按下背部时调用键。默认实现只是完成当前活动,但是你可以覆盖它来做任何你想做的事。

公众空隙 onConfigurationChanged(配置已更改) (配置新配置)

已在中添加API级别1

当您的活动正在运行。请注意,这将只有在以下情况下被调用您已经选择了要处理的配置配置更改清单中的属性。如果发生任何未选择报告的配置更改根据该属性,系统将停止而不是报告并重新启动活动(用新的配置)。

在调用此函数时,您的资源对象将被更新以返回与新配置。

参数
新配置 新设备配置。

公众空隙 onContentChanged(内容已更改) ()

已在中添加API级别1

每当屏幕的内容视图更改时,都会调用此挂钩(由于打电话给窗口.设置内容视图窗口添加内容视图).

公众布尔值 已选择上下文项 (菜单项项目)

已在中添加API级别1

每当选中上下文菜单中的项时,就会调用此挂钩。这个默认实现只返回false以进行正常处理发生(调用项目的Runnable或向其Handler发送消息视情况而定)。您可以对任何项目使用此方法想在没有其他设施的情况下进行加工。

使用获取菜单信息()获取由添加此菜单项的视图。

派生类应调用基类以执行默认菜单处理。

参数
项目 选定的上下文菜单项。
退换商品
  • boolean返回false以允许正常上下文菜单处理继续,在这里消费。

公众空隙 onContextMenuClosed(上下文菜单关闭) (菜单菜单)

已在中添加API级别1

每当上下文菜单被关闭时(通过用户使用back/menu按钮取消菜单,或者当项目选中)。

参数
菜单 正在关闭的上下文菜单。

公众空隙 onCreateContextMenu(创建上下文菜单) (上下文菜单菜单,查看v、,上下文菜单。上下文菜单信息菜单信息)

已在中添加API级别1

当上下文菜单看法即将显示。不同于onCreateOptionsMenu(菜单),这将被称为上下文菜单即将显示并应填充的时间视图(或视图中的项适配器视图子类,这可以在菜单信息)).

使用onContextItemSelected(android.view.MenuItem)知道何时项已选定。

在该方法返回后保持上下文菜单是不安全的。

参数
菜单 正在生成的上下文菜单
v(v) 正在为其构建上下文菜单的视图
菜单信息 有关项目的附加信息应该显示上下文菜单。此信息将有所不同取决于v的类别。

公众的字符序列 onCreateDescription(创建描述) ()

已在中添加API级别1

生成此活动的新描述。此方法称为暂停活动之前,如果需要,可以返回一些文本要显示给用户的当前状态的描述。

默认实现返回null,这将导致您继承上一个活动的描述。如果所有活动返回null,通常顶级活动的标签将用作描述。

退换商品
  • 用户正在执行的操作的描述。它应该很短并且甜蜜(只有几个字)。

公众空隙 onCreateNavigateUpTaskStack (任务堆栈生成器建筑商)

已在中添加API级别16

定义将在向上导航期间从生成的合成任务堆栈不同的任务。

此方法的默认实现添加此活动的父链按照提供的清单中的规定任务堆栈生成器.应用程序可以选择重写此方法以在不同的方式。

此方法将由的默认实现调用onNavigateUp()如果应该重新创建任务(意图)提供意图时返回true由返回获取家长活动意向().

希望为定义的父堆栈提供额外Intent参数的应用程序由清单覆盖onPrepareNavigateUpTaskStack(TaskStackBuilder).

参数
建设者 空TaskStackBuilder-应用程序应添加表示所需的任务堆栈

公众布尔值 onCreateOptions菜单 (菜单菜单)

已在中添加API级别1

初始化“活动”标准选项菜单的内容。应该将菜单项放入菜单.

这只调用一次,第一次选项菜单是显示。要在每次显示菜单时更新菜单,请参阅onPrepareOptionsMenu(菜单).

默认实现使用标准系统填充菜单菜单项。这些放在类别_系统分组,以便它们将使用应用程序定义的菜单项进行正确排序。派生类应始终调用基实现。

你可以安全地抓住菜单(以及创建的任何项目根据需要对其进行修改,直到下一个调用CreateOptionsMenu()上的时间。

当您向菜单添加项目时,可以实现“活动”onOptionsItemSelected(菜单项)方法在那里处理它们。

参数
菜单 放置项目的选项菜单。
退换商品
  • 您必须返回true才能显示菜单;如果返回false,则不会显示。

公众布尔值 在CreatePanel菜单上 (int featureId,菜单菜单)

已在中添加API级别1

的默认实现onCreatePanelMenu(int,菜单)用于活动。这呼唤着新的onCreateOptionsMenu(菜单)方法功能_选项_面板面板,这样Activity的子类就不需要处理功能代码。

参数
功能ID 正在创建的面板。
菜单 面板内的菜单。
退换商品
  • boolean要显示面板,必须返回true;如果返回false,则不会显示。

公众的查看 在CreatePanelView上 (int featureId)

已在中添加API级别1

的默认实现onCreatePanelView(int)用于活动。这个只需返回null,以便所有面板子窗口都具有默认值菜单行为。

参数
功能ID 正在创建哪个面板。
退换商品
  • view要放置在面板中的顶层视图。

公众布尔值 在创建缩略图时 (位图outBitmap,帆布帆布)

已在中添加API级别1

为此活动生成新缩略图。此方法在之前调用暂停活动,并应进入outBitmap(输出位图)这个以该位图的尺寸显示所需缩略图的图像。可以使用给定的帆布,配置为将位图,用于渲染(如果需要)。

默认实现返回失败且未绘制缩略图;这将导致平台在需要时创建自己的缩略图。

参数
outBitmap(输出位图) 包含缩略图的位图。
帆布 可用于渲染到位图中。
退换商品
  • 如果已绘制到位图中,则返回true;否则在之后返回时,它将使用默认缩略图填充。

公众的查看 在CreateView上 (查看起源,字符串名称,上下文上下文,属性集属性)

已在中添加API级别11

标准实施onCreateView(视图、字符串、上下文、属性集)使用返回的LayoutInflator进行充气时使用getSystemService(字符串).此实现处理标签将片段嵌入其中活动的。

参数
起源 将放置所创建视图的父视图中;请注意,这可能为空.
名称 要膨胀的标记名称。
上下文 正在创建视图的上下文。
属性 XML文件中指定的充气属性。
退换商品
  • 查看新创建的视图。默认值返回null行为。

公众的查看 在CreateView上 (字符串名称,上下文上下文,属性集属性)

已在中添加API级别1

标准实施onCreateView(字符串、上下文、属性集)在以下情况下使用使用返回的LayoutInflator进行充气getSystemService(字符串).此实现不执行任何操作,用于预(pre)-蜂巢应用程序。更新的应用程序应该使用onCreateView(视图、字符串、上下文、属性集).

参数
名称 要膨胀的标记名称。
上下文 正在其中创建视图的上下文。
属性 XML文件中指定的膨胀属性。
退换商品
  • 查看新创建的视图。默认值返回null行为。

公众空隙 从窗口分离 ()

已在中添加API级别5

当与活动关联的主窗口与窗口管理器分离。请参见查看.onDetachedFromWindow()了解更多信息。

另请参阅

公众布尔值 onGeneric运动事件 (MotionEvent(运动事件)事件)

已在中添加API级别12

当任何活动内部的视图。

通用运动事件描述操纵杆运动、鼠标悬停、轨迹板触摸、滚轮移动和其他输入事件。这个来源运动事件的收到的输入的类别。此方法的实现必须在处理事件之前检查源中的位。下面的代码示例演示了如何完成此操作。

具有源类的通用运动事件源类别指针传递到指针下的视图。所有其他通用运动事件包括交付给焦点视图。

请参见onGenericMotionEvent(运动事件)有关如何执行以下操作的示例处理此事件。

参数
事件 正在处理的通用运动事件。
退换商品
  • 如果您已使用事件,则返回true;如果尚未使用,则返回false。默认实现总是返回false。

公众布尔值 onKeyDown(按向下键) (int keyCode,键盘事件事件)

已在中添加API级别1

当按键被按下且未被任何视图处理时调用活动内部。例如,当光标移动时按键在TextView中不会触发事件(除非它是导航另一个对象),因为TextView处理自己的按键。

如果焦点视图不需要此事件,则调用此方法。

默认实现负责钥匙代码_背面通过呼叫后按()尽管行为会因情况而异关于应用程序兼容性模式:for拉加经委会或更高版本的应用程序,它将设置调度呼叫onKeyUp(int,KeyEvent)其中动作将执行;对于早期的应用程序,它将执行立即采取行动,如平台的那些版本表现良好。

可以执行其他默认密钥处理如果配置为setDefaultKeyMode(int).

参数
密钥代码 event.getKeyCode()中的值。
事件 关键事件的描述。
退换商品
  • 返回真的以防止传播此事件进一步,或表示您尚未处理这个事件应该继续传播。

公众布尔值 onKeyLongPress上 (int keyCode,键盘事件事件)

已在中添加API级别5

的默认实现KeyEvent。回调.onKeyLongPress():始终返回false(不处理事件)。

参数
keyCode(密钥代码) event.getKeyCode()中的值。
事件 关键事件的描述。
退换商品
  • 如果您处理了事件,则返回true。如果您想允许下一个接收方要处理的事件返回false。

公众布尔值 onKeyMultiple (int keyCode,int repeatCount,键盘事件事件)

已在中添加API级别1

的默认实现KeyEvent。回调.onKeyMultiple():始终返回false(不处理事件)。

参数
keyCode(密钥代码) event.getKeyCode()中的值。
repeatCount(重复计数) event.getRepeatCount()返回的对数。
事件 关键事件的描述。
退换商品
  • 如果您处理了事件,则返回true。如果您想允许下一个接收方要处理的事件返回false。

公众布尔值 on键快捷方式 (int keyCode,键盘事件事件)

已在中添加API级别11

当“活动”中的任何视图都未处理键快捷方式事件时调用。重写此方法以实现“活动”的全局键快捷方式。也可以通过设置快捷方式菜单项的属性。

参数
keyCode(密钥代码) event.getKeyCode()中的值。
事件 关键事件的描述。
退换商品
  • 如果处理了快捷键,则为True。

公众布尔值 on键向上 (int keyCode,键盘事件事件)

已在中添加API级别1

当密钥被释放且未被任何视图处理时调用活动内部。例如,当光标移动时按键在TextView中不会触发事件(除非它是导航另一个对象),因为TextView处理自己的按键。

默认实现处理KEYCODE_BACK以停止活动然后回去。

参数
keyCode(密钥代码) event.getKeyCode()中的值。
事件 关键事件的描述。
退换商品
  • 返回真的以防止传播此事件进一步,或表示您尚未处理这个事件应该继续传播。

公众空隙 在低内存上 ()

已在中添加API级别1

这是在整个系统内存不足时调用的,并且主动运行的进程应该减少内存使用。While期间通常,调用该函数的确切点没有定义当所有后台进程都被终止时,就会发生这种情况。也就是说,在达到终止进程托管点之前我们希望避免杀戮的服务和前台UI。

您应该实现此方法以释放您可能持有的任何缓存或其他不必要的资源。从该方法返回后,系统将为您执行垃圾收集。

最好,您应该实现onTrimMemory(int)组件回调2根据不同的内存需求的级别。该API可用于API级别14及更高级别,因此您应该只使用这个低内存()方法作为旧版本的备用方法,可以是被视为onTrimMemory(int)使用TRIM_MEMORY_COMPLETE(内存完整)级别。

公众布尔值 已选择菜单项 (int featureId,菜单项项目)

已在中添加API级别1

的默认实现onMenuItemSelected(int,MenuItem)用于活动。这呼唤着新的onOptionsItemSelected(菜单项)方法功能_选项_面板面板,以便活动不需要处理功能代码。

参数
功能ID 菜单所在的面板。
项目 选定的菜单项。
退换商品
  • boolean返回true以完成选择的处理,或false执行正常的菜单处理(调用其可运行或向其目标处理程序发送消息)。

公众布尔值 打开菜单时 (int featureId,菜单菜单)

已在中添加API级别1

当用户打开面板菜单时调用。这也可能是当菜单从一种类型更改为另一种类型时调用(用于例如,从图标菜单到展开菜单)。

参数
功能ID 菜单所在的面板。
菜单 打开的菜单。
退换商品
  • 默认实现返回true。

公众布尔值 onNavigateUp(导航上) ()

已在中添加API级别16

每当用户选择在应用程序的操作栏中的活动层次结构。

如果属性家长活动名称在清单中为此活动或其活动别名指定,默认的向上导航将自动处理。如果有任何活动沿着父链需要额外的Intent参数,Activity子类应重写该方法onPrepareNavigateUpTaskStack(TaskStackBuilder)提供这些论据。

请参见任务和后备堆栈来自开发人员指南和导航有关在应用程序中导航的更多信息,请参阅《设计指南》。

请参阅任务堆栈生成器类和Activity方法获取家长活动意向(),应该重新创建任务(意图)、和navigateUpTo(目的)以帮助实现自定义向上导航。Android SDK中的AppNavigation示例应用程序也可供参考。

退换商品
  • 如果Up导航成功完成且此“活动”已完成,则为true,否则为false。

公众布尔值 从子级向上导航 (活动儿童)

已在中添加API级别16

当此活动的子活动尝试向上导航时,将调用此函数。默认实现只对该活动(父活动)调用onNavigateUp()。

参数
小孩 拨打电话的活动。

公众布尔值 所选选项项目 (菜单项项目)

已在中添加API级别1

只要选择了选项菜单中的项目,就会调用此挂钩。默认实现只返回false以获得正常处理发生(调用项目的Runnable或向发送消息(视情况而定)。您可以对任何项目使用此方法您希望在没有其他人的情况下进行处理设施。

派生类应调用基类以使其执行默认菜单处理。

参数
项目 选定的菜单项。
退换商品
  • boolean返回false以允许正常菜单处理继续,在这里消费。

公众空隙 onOptions菜单关闭 (菜单菜单)

已在中添加API级别1

每当选项菜单关闭时(用户取消具有后退/菜单按钮的菜单或当选择项目时)。

参数
菜单 最后显示的选项菜单或由初始化的选项菜单onCreateOptionsMenu()。

公众空隙 面板关闭时 (int featureId,菜单菜单)

已在中添加API级别1

的默认实现onPanelClosed(int,菜单)对于活动。这呼叫到onOptionsMenuClosed(菜单)方法功能_选项_面板面板,这样Activity的子类就不需要处理功能代码。对于上下文菜单(FEATURE_CONTEXT_MENU(功能_上下文_菜单)),的onContextMenuClosed(菜单)将被调用。

参数
功能ID 正在显示的面板。
菜单 如果onCreatePanelView()返回null,这是菜单显示在面板中。

公众空隙 onPrepareNavigateUpTaskStack (任务堆栈生成器建筑商)

已在中添加API级别16

准备将在向上导航期间生成的合成任务堆栈来自不同的任务。

此方法接收任务堆栈生成器用构造的系列由产生的意图onCreateNavigateUpTaskStack(任务堆栈生成器).如果在启动新任务之前需要向这些意图添加任何额外数据,应用程序应该覆盖此方法并在此处添加该数据。

参数
建设者 TaskStackBuilder已由填充了Intents在CreateNavigateUpTaskStack上。

公众布尔值 onPrepareOptions菜单 (菜单菜单)

已在中添加API级别1

准备要显示的屏幕标准选项菜单。这是每次显示菜单之前都会调用。你可以使用此方法可以有效地启用/禁用项目或其他动态修改内容。

默认实现根据活动的状态。派生类应始终调用基类实现。

参数
菜单 最后显示的选项菜单或由初始化的选项菜单onCreateOptionsMenu()。
退换商品
  • 您必须返回true才能显示菜单;如果返回false,则不会显示。

公众布尔值 在PreparePanel上 (int featureId,查看视图,菜单菜单)

已在中添加API级别1

的默认实现onPreparePanel(int、View、Menu)用于活动。这个呼叫新的onPrepareOptionsMenu(菜单)方法功能_选项_面板面板,以便活动不需要处理功能代码。

参数
功能ID 正在显示的面板。
看法 onCreatePanelView()返回的视图。
菜单 如果onCreatePanelView()返回null,则这是菜单显示在面板中。
退换商品
  • boolean要显示面板,必须返回true;如果返回false,则不会显示。

公众空隙 提供辅助数据 (捆绑数据)

已在中添加API等级18

当用户请求帮助时调用此函数,以构建完整的动作_助理意图与当前的所有上下文应用程序。您可以重写此方法以将任何内容放入包中你想出现在额外_辅助_内容部分协助意向。默认实现不执行任何操作。

此函数将在具有已向注册应用程序.registerOnProvideAssistDataListener.

公众的对象 onRetainNonConfigurationInstance ()

已在中添加API级别1

此方法已弃用API等级13。
使用新的碎片美国石油学会setRetainInstance(布尔值)相反;这也是可通过Android兼容性包在较旧的平台上使用。

由系统调用,作为销毁当已知新的实例将立即为新配置创建。可以在此处返回任何对象,包括活动实例自身,稍后可以通过调用获取最后一个非配置实例()在新活动中实例。如果你的目标是蜂巢或稍后,考虑使用碎片具有Fragment.setRetainInstance(布尔值.

此函数纯粹作为优化调用,您必须不依赖于它被调用。当它被调用时,一些保证将帮助优化配置切换:

这些保证旨在使活动可以使用此API将大量状态从旧活动实例传播到新活动实例加载的位图,到网络连接,到均匀主动运行线程。请注意,您应该传播任何符合以下条件的数据可能会根据配置进行更改,包括从中加载的任何数据资源,如字符串、布局或绘图。

保证在切换到下一个期间不进行消息处理activity简化了对活动对象的使用。例如,如果您保留了状态是异步任务你可以保证回调函数(如onPostExecute(结果))遗嘱在执行下一个实例的onCreate(捆绑包)(但请注意,当然没有担保doInBackground(参数…)因为那是在单独的线程中运行。)

退换商品
  • 返回任何保持所需状态的对象以传播到下一个活动实例。

公众布尔值 请求的搜索 ()

已在中添加API级别1

当用户发出开始搜索的信号时,将调用此钩子。

您可以使用此函数作为启动搜索UI的简单方法,以响应菜单项、搜索按钮或活动中的其他小部件。除非过高,调用此函数与调用相同startSearch(空、假、空、假),启动搜索清单中指定的当前活动,请参阅浮动搜索框.

您可以覆盖此功能以强制全局搜索,例如响应专用搜索键,或完全阻止搜索(只需返回false)。

退换商品
  • 退换商品真的如果启动搜索,以及如果活动阻止了它。默认实现总是返回真的.
另请参阅

公众布尔值 onTouchEvent(接通触摸事件) (MotionEvent(运动事件)事件)

已在中添加API级别1

当任何视图都未处理触摸屏事件时调用这对于处理发生的触摸事件非常有用在窗口边界之外,没有可接收它的视图。

参数
事件 正在处理的触摸屏事件。
退换商品
  • 如果您已使用事件,则返回true;如果尚未使用,则返回false。默认实现总是返回false。

公众布尔值 onTrackball活动 (MotionEvent(运动事件)事件)

已在中添加API级别1

当轨迹球被移动且未被任何活动内部的视图。例如,如果轨迹球移动当焦点放在按钮上时,您将在此处收到一个呼叫,因为按钮通常对轨迹球事件没有任何作用。电话这里发生了之前轨迹球运动转换为DPAD键事件,然后将其发送回视图层次结构,以及将在焦点导航等情况下进行处理。

参数
事件 正在处理的轨迹球事件。
退货
  • 如果您已使用事件,则返回true;如果尚未使用,则返回false。默认实现总是返回false。

公众空隙 onTrimMemory(调整内存) (int级)

已在中添加API级别14

当操作系统确定它是好的时调用进程从其进程中删除不需要的内存的时间。这将例如,当它进入后台时,没有足够的内容内存以使尽可能多的后台进程运行。不得与液位的精确值进行比较,因为新的中间物可以添加值--您通常需要比较大于或等于您感兴趣的级别。

要在任何时候检索进程的当前微调级别,您可以使用ActivityManager.getMyMemoryState(RunningAppProcessInfo).

公众空隙 onUserInteraction(用户交互) ()

已在中添加API级别3

每当向发送按键、触摸或轨迹球事件时调用活动。如果您想知道用户已经在活动运行时以某种方式与设备进行交互。此回调和onUserLeaveHint()旨在提供帮助活动智能地管理状态栏通知;明确地,帮助活动确定取消通知的适当时间。

所有对您活动的呼叫onUserLeaveHint()回调将同时打电话给onUserInteraction()。这个确保您的活动将被告知相关的用户活动,例如如下拉通知窗格并触摸其中的项目。

请注意,此回调将被调用用于触地跌落操作它开始一个触摸手势,但可能不会被触动调用以及随后的修补行动。

另请参阅

公众空隙 窗口属性已更改 (窗口管理器。布局参数参数)

已在中添加API级别1

只要当前窗口属性更改,就会调用此函数。

公众空隙 onWindows焦点已更改 (布尔值hasFocus)

已在中添加API级别1

当当前窗口活动的得失集中。这是该活动是否可见的最佳指示器发送给用户。默认实现清除密钥跟踪状态,因此应始终调用。

请注意,这提供了有关全局焦点状态的信息独立于活动生命周期进行管理。因此,在关注的同时更改通常与生命周期更改(停止的活动通常不会获得窗口焦点)不应依赖于此处回调和之间的任何特定顺序其他生命周期方法中的onResume().

然而,一般来说,恢复的活动将有窗口集中。。。除非它显示了其他需要输入焦点,在这种情况下,活动本身将没有焦点当其他窗口有它时。同样,系统可能会显示系统级窗口(例如状态栏通知面板或一个系统警报),它将在没有暂停前台活动。

参数
has焦点 此活动的窗口是否有焦点。

公众的操作模式 onWindows启动操作模式 (ActionMode(操作模式)。回拨回调)

已在中添加API级别11

让“活动”有机会控制请求的操作模式的UI由系统决定。

注意:如果您正在寻找一个通知回调已为此活动启动,请参阅onActionModeStarted(ActionMode)(操作模式).

参数
回调 应该控制新操作模式的回调
退换商品
  • 新的行动模式,或无效的如果活动不想为此操作模式提供特殊处理。(将由系统处理。)

公众空隙 打开上下文菜单 (查看视图)

已在中添加API级别1

以编程方式打开特定看法.这个看法应通过添加注册表用于上下文菜单(视图).

参数
看法 显示上下文菜单的视图。

公众空隙 打开选项菜单 ()

已在中添加API级别1

以编程方式打开选项菜单。如果选项菜单已经存在打开时,此方法不执行任何操作。

公众空隙 覆盖PendingTransition (int enterAnim,int exitAnim)

已在中添加API级别5

在品尝完其中一种口味后立即致电startActivity(目的)完成()将显式过渡动画指定给执行下一步。

截至杰利·比恩另一种选择在开始活动时使用它是为了提供所需的动画信息通过活动选项捆绑到{@link#startActivity(Intent,Bundle)或相关函数。这允许您可以指定自定义动画,即使在从开始活动时也是如此在当前top活动的上下文之外。

参数
enterAnim公司 要用于的动画资源的资源ID传入的活动。使用0表示无动画。
exit动画 要用于的动画资源的资源ID外出活动。使用0表示无动画。

公众空隙 重新创建 ()

已在中添加API级别11

使用新实例重新创建此“活动”。这个结果由于配置更改--当前实例将经历其生命周期到onDestroy()然后创建一个新实例。

公众空隙 注册表用于上下文菜单 (查看视图)

已在中添加API级别1

注册要为给定视图显示的上下文菜单(多个视图可以显示上下文菜单)。此方法将设置查看。OnCreateContextMenuListener关于此活动的视图,所以onCreateContextMenu(上下文菜单,视图,上下文菜单信息)在显示上下文菜单时调用。

参数
看法 应该显示上下文菜单的视图。

公众最终空隙 删除对话框 (int id)

已在中添加API级别1

此方法已弃用API等级13。
使用新的对话框片段与一起上课碎片管理器相反;这也是可通过Android兼容性包在较旧的平台上使用。

删除对此“活动”管理的对话框的任何内部引用。如果显示该对话框,它将在清理过程中关闭该对话框。

如果您知道永远不会再显示对话框,并且希望避免将来保存和恢复它的开销。

截至姜饼,此函数如果您尝试删除一个没有当前有一个关联的对话框。

参数
身份证件 托管对话框的id。

公众空隙 报告完全提取 ()

已在中添加API等级19

向系统报告您的应用程序现在已完全绘制,仅用于诊断目的(调用它不会影响活动的可见行为)。这仅用于帮助仪器应用程序启动时间,以便应用程序可以在其完全处于可用状态时进行报告;没有这个,唯一的东西系统本身可以确定活动窗口的点第一绘制并显示。参与应用程序启动时间测量时,应始终在首次启动后调用此方法(当onCreate(android.os.Bundle)被称为),在您拥有完全绘制了您的UI并填充了所有重要数据。在首次启动后的任何时候都可以安全地调用此方法,在这种情况下它将被简单地忽略。

公众最终布尔值 请求窗口功能 (int featureId)

已在中添加API级别1

启用扩展窗口功能。这是打电话的方便getWindow().requestFeature().

参数
功能ID 中定义的所需功能窗口.
退换商品
  • 如果现在支持请求的功能,则返回true已启用。

公众最终空隙 运行OnUiThread (可跑步动作)

已在中添加API级别1

在UI线程上运行指定的操作。如果当前线程是UI线程,然后立即执行操作。如果当前线程是不是UI线程,该操作被发布到UI线程的事件队列。

参数
行动 要在UI线程上运行的操作

公众空隙 设置内容视图 (int layoutResID)

已在中添加API级别1

从版面资源设置活动内容。资源将是膨胀,将所有顶级视图添加到活动中。

参数
布局ResID 要膨胀的资源ID。

公众空隙 设置内容视图 (查看视图)

已在中添加API级别1

将活动内容设置为显式视图。放置此视图直接进入活动的视图层次结构。它本身可以是一个综合体视图层次结构。调用此方法时忽略指定的视图。视图的宽度和高度都是默认设置为匹配_区域.使用您自己的布局参数,调用setContentView(android.view.view,android.view.ViewGroup.LayoutParams)相反。

参数
看法 要显示的所需内容。

公众空隙 设置内容视图 (查看视图,查看组。布局参数参数)

已在中添加API级别1

将活动内容设置为显式视图。此视图已放置直接进入活动的视图层次结构。它本身可以是一个综合体视图层次结构。

参数
看法 要显示的所需内容。
参数 视图的布局参数。

公众最终空隙 设置默认键模式 (int模式)

已在中添加API级别1

选择此活动的默认密钥处理。这控制了什么将发生未以其他方式处理的关键事件。默认值模式(默认键禁用)只需将它们放在地板。其他模式允许您启动拨号程序(默认_KEYS_DIALER),在选项中执行快捷方式菜单,而不需要按住菜单键(默认键快捷键),或启动搜索(默认_KEYS_SEARCH_LOCAL默认_KEYS_SEARCH_GLOBAL).

请注意,此处选择的模式不会影响默认值处理系统键,如“back”和“menu”键,以及活动及其视图总是有第一次机会接收和处理所有应用程序密钥。

参数
模式 所需的默认键模式常量。

公众最终空隙 setFeatureDrawable(设置功能可绘制) (int featureId,可提取可抽出)

已在中添加API级别1

公众最终空隙 setFeatureDrawableAlpha (int featureId,int alpha)

已在中添加API级别1

公众最终空隙 setFeatureDrawableResource(设置功能可拖动资源) (int featureId,int resId)

已在中添加API级别1

公众最终空隙 setFeatureDrawableUri (int featureId,乌里uri)

已在中添加API级别1

公众空隙 设置触摸外部完成 (布尔完成)

已在中添加API级别11

设置此活动在其窗口外触摸时是否完成边界。

公众空隙 设置沉浸式 (布尔值i)

已在中添加API等级18

调整当前沉浸式模式设置。请注意,更改此值不会影响活动的活动信息结构;也就是说,如果android:沉浸式设置为真的在该活动的应用程序清单条目中活动信息.flags会员将总是有它的标志_ MMERSIVE位设置。

公众空隙 setIntent(设置意图) (意图newIntent)

已在中添加API级别1

更改返回的意图获取Intent()。它包含一个对给定意图的引用;它不会复制它。常用于与…结合onNewIntent(意向).

参数
newIntent(新建意向) 要从getIntent返回的新Intent对象

公众最终空隙 设置进度 (int进度)

已在中添加API级别1

设置标题中进度条的进度。

为了显示进度条,必须请求该功能通过请求窗口功能(int).

参数
进步 进度条的进度。有效范围从0到10000(含0和10000)。如果给出10000,进度酒吧将被完全填满,并将淡出。

公众最终空隙 设置进度条不确定 (布尔不定)

已在中添加API级别1

设置标题中的水平进度条是否不确定(圆形总是不确定的)。

为了显示进度条,必须请求该功能通过请求窗口功能(int).

参数
不确定的 水平进度条是否应该是不确定的。

公众最终空隙 设置进度条索引可见性 (布尔可见)

已在中添加API级别1

设置标题中不确定进度条的可见性。

为了显示进度条,必须请求该功能通过请求窗口功能(int).

参数
看得见的 是否在标题中显示进度条。

公众最终空隙 设置进度条可见性 (布尔可见)

已在中添加API级别1

设置标题中进度条的可见性。

为了显示进度条,必须请求该功能通过requestWindowFeature(int).

参数
看得见的 是否在标题中显示进度条。

公众空隙 设置请求的方向 (int请求定向)

已在中添加API级别1

更改此活动的所需方向。如果活动当前位于前台或影响屏幕方向,屏幕将立即更改(可能导致要重新启动的活动)。否则,将在下一个活动可见的时间。

参数
要求的方向 中使用的方向常数活动信息.屏幕方向.

公众最终空隙 setResult(设置结果) (int resultCode)

已在中添加API级别1

调用此函数以设置您的活动将返回到其呼叫方。

参数
结果代码 要传播回原始的结果代码活动,通常为RESULT_CANCELED或RESULT_OK

公众最终空隙 setResult(设置结果) (int结果代码,意图数据)

已在中添加API级别1

调用此函数以设置您的活动将返回到其呼叫方。

截至姜饼,意图你可以在这里供应意图。标志_授权_读取_权限和/或意图。标志_授权_写入_权限设置。这将授予接收对意向中特定URI的结果访问的活动。在“活动”完成之前,将保持访问权限(它将在整个宿主中保持进程被终止和其他临时销毁),并将添加它已经拥有的任何现有URI权限集。

参数
结果代码 要传播回原始的结果代码活动,通常为RESULT_CANCELED或RESULT_OK
数据 要传播回原始活动的数据。

公众最终空隙 设置次要进度 (int secondaryProgress)

已在中添加API级别1

设置标题中进度条的次要进度。这个在主要进度之间绘制进度(通过设置设置进度(int)和背景。它可能是媒体的理想选择场景,例如显示缓冲进程,而默认进度表示游戏进度。

为了显示进度条,必须请求该功能通过请求窗口功能(int).

参数
次要进度 进度条的次要进度。有效范围从0到10000(含0和10000)。

公众空隙 集合标题 (int titleId)

已在中添加API级别1

更改与此活动关联的标题。如果这是顶级活动,其窗口的标题将更改。如果是这样是一个嵌入式活动,父级可以做任何它想做的事情用它。

公众空隙 集合标题 (字符序列标题)

已在中添加API级别1

更改与此活动关联的标题。如果这是一个顶级活动,其窗口的标题将更改。如果是这样是一个嵌入的活动,父级可以做它想做的任何事情用它。

公众空隙 设置标题颜色 (int textColor)

已在中添加API级别1

公众空隙 设置可见 (布尔可见)

已在中添加API级别3

控制此活动的主窗口是否可见。这是为了仅适用于不会显示UI本身,但不能在onResume()之前完成,因为它需要等待服务绑定等。将此设置为false允许您可以阻止在此期间显示UI。

其默认值取自窗口无显示活动主题的属性。

公众最终空隙 音频流 (int streamType)

已在中添加API级别1

建议硬件应更改其音量的音频流音量控制。

建议的音频流将绑定到此“活动”的窗口。如果切换了“活动”,则此处设置的流不再是建议的流。客户端不需要保存和恢复旧的onPause和onResume中的建议流值。

参数
流类型 音量应为的音频流的类型由硬件音量控制更改。不能保证硬件音量控制将始终更改此流的卷(例如,如果调用正在进行,则其流的卷可能会更改)。要重置回默认值,请使用使用默认流类型.

公众布尔值 应该向上重新创建任务 (意图目标意图)

已在中添加API级别16

如果应用程序在从该活动“向上”导航时应重新创建任务,则返回true使用targetIntent。

如果此方法返回false,应用程序可以轻松调用navigationUpTo(意向)使用相同的参数正确执行向上导航。如果此方法返回false,应用程序应合成新的任务堆栈通过使用任务堆栈生成器或其他类似机制来执行导航。

参数
目标意图 表示上行导航目标目的地的意图
退换商品
  • 如果向上导航应重新创建新任务堆栈,则为true;如果是同一任务,则为false应用于目的地

公众最终布尔值 显示对话框 (int id,捆绑参数)

已在中添加API级别8

此方法已弃用空气污染指数第13级。
使用新的对话框片段与一起上课碎片管理器相反;这也是可通过Android兼容性包在较旧的平台上使用。

显示此活动管理的对话框。打电话给onCreateDialog(int,捆绑)将在第一次为给定的id.此后,对话框将自动保存和恢复。如果你的目标是蜂巢或稍后,考虑使用对话框片段相反。

每次显示对话框时,onPrepareDialog(int、Dialog、Bundle)提供及时准备的机会。

参数
身份证件 托管对话框的id。
参数 要传递到对话框的参数。这些将被保存并为您恢复。注意,如果已经创建了对话框,onCreateDialog(int,捆绑)不会用新的参数,但onPrepareDialog(int、Dialog、Bundle)将。如果需要重新生成对话框,请调用删除对话框(int)首先。
退货

公众最终空隙 显示对话框 (内部id)

已在中添加API级别1

此方法已弃用API等级13。
使用新的对话框片段与一起上课碎片管理器相反;这也是可通过Android兼容性包在较旧的平台上使用。

的简单版本showDialog(int,捆绑)那不是接受任何论据。只需打电话showDialog(int,捆绑)参数为null。

公众的操作模式 启动操作模式 (ActionMode(操作模式)。回拨回调)

已在中添加API级别11

启动操作模式。

参数
回调 将管理此上下文模式的生命周期事件的回调
退换商品
  • 启动的ContextMode,如果取消则为null
另请参阅

公众空隙 启动活动 (意向[]意图,捆绑选项)

已在中添加API级别16

启动新活动。您不会收到任何关于何时活动退出。该实现方式覆盖基本版本,提供有关的信息执行启动的活动。因为这个额外的信息标志_活动_新任务启动标志不是必修的;如果未指定,则新活动将添加到调用方的任务。

此方法引发活动未找到异常如果没有找到运行给定Intent的Activity。

参数
意图 打算开始。
选项 应如何启动“活动”的其他选项。请参见Context.startActivity(意向,捆绑)了解更多详细信息。
投掷
android内容。活动未找到异常

公众空隙 启动活动 (意向[]意图)

已在中添加API级别11

等同于startActivities(意向[],捆绑)没有选项明确规定。

参数
意图 打算开始。
投掷
android内容。活动未找到异常

公众空隙 启动活动 (意图意图)

已在中添加API级别1

等同于startActivity(意向、捆绑)没有选项明确规定。

参数
意图 开始的意图。
投掷
android内容。活动未找到异常

公众空隙 启动活动 (意图意图,捆绑选项)

已在中添加API级别16

启动新活动。您将不会收到任何关于何时活动退出。此实现覆盖基本版本,提供有关的信息执行启动的活动。因为这个额外的信息标志_活动_新任务启动标志不是必修的;如果未指定,则新活动将添加到调用方的任务。

此方法引发活动未找到异常如果没有找到运行给定Intent的Activity。

参数
意图 开始的意图。
选项 有关如何启动“活动”的其他选项。请参见Context.startActivity(意向,捆绑)了解更多详细信息。
投掷
android内容。活动未找到异常

公众空隙 启动结果活动 (意图intent,int请求代码)

已在中添加API级别1
参数
意图 开始的意图。
请求代码 如果>=0,则此代码将在onActivityResult()。
投掷
android内容。活动未找到异常

公众空隙 启动结果活动 (意图intent,int请求代码,捆绑选项)

已在中添加API级别16

启动一项活动,您希望在活动结束时获得结果。当此活动退出时,您的将使用给定的requestCode调用onActivityResult()方法。使用负requestCode与调用startActivity(目的)(该活动不是作为子活动启动的)。

请注意,此方法只能用于Intent协议定义为返回结果的。在其他协议中(例如动作_主操作视图),你可以没有得到你期望的结果。例如,如果正在使用singleTask启动模式启动,它不会在您的任务,因此您将立即收到取消结果。

特殊情况下,如果使用requestCode调用startActivityForResult()>在您的活动,则您的窗口将不会显示,直到出现结果从已启动的活动返回。这是为了避免可见重定向到另一个活动时闪烁。

此方法引发活动未找到异常如果没有找到运行给定Intent的Activity。

参数
意图 开始的意图。
请求代码 如果>=0,则此代码将在onActivityResult()。
选项 有关如何启动“活动”的其他选项。请参见Context.startActivity(意向,捆绑)了解更多详细信息。
投掷
android内容。活动未找到异常

公众空隙 从子项启动活动 (活动儿童,意图intent,int请求代码,捆绑选项)

已在中添加API级别16

当此活动的子活动调用其startActivity(目的)startActivityForResult(意向,int)方法。

此方法引发活动未找到异常如果没有找到运行给定Intent的Activity。

参数
小孩 拨打电话的活动。
意图 开始的意图。
请求代码 回复请求代码。<如果未请求回复,则返回0。
选项 有关如何启动“活动”的其他选项。请参见Context.startActivity(意向,捆绑)了解更多详细信息。
投掷
android内容。活动未找到异常

公众空隙 从子项启动活动 (活动孩子,意图intent,int requestCode)

已在中添加API级别1
参数
小孩 拨打电话的活动。
意图 开始的意图。
请求代码 回复请求代码。<如果未请求回复,则返回0。
投掷
android内容。活动未找到异常

公众空隙 从片段开始活动 (碎片片段,意图intent,int请求代码,捆绑选项)

已在中添加API级别16

当此活动中的片段调用其startActivity(目的)startActivityForResult(意向,int)方法。

此方法引发活动未找到异常如果没有找到运行给定Intent的Activity。

参数
片段 进行调用的片段。
意图 开始的意图。
请求代码 回复请求代码。<如果未请求回复,则返回0。
选项 应如何启动“活动”的其他选项。请参见Context.startActivity(意向,捆绑)了解更多详细信息。
投掷
android内容。活动未找到异常

公众空隙 从片段开始活动 (碎片碎片,意图intent,int requestCode)

已在中添加API级别11
参数
片段 进行调用的片段。
意图 开始的意图。
请求代码 回复请求代码。<如果未请求回复,则返回0。
投掷
android内容。活动未找到异常

公众布尔值 启动活动(如果需要) (意图intent,int请求代码,捆绑选项)

已在中添加API级别16

仅在新活动时启动活动的特殊变体实例来处理给定的Intent。换句话说,这是就像startActivityForResult(意向,int)除非:如果你是使用FLAG_ACTIVITY_SINGLE_TOP标志标志,或singleTask或singleTop启动模式,和活动可以处理意图与您当前运行的相同活动,则不需要新实例。在这种情况下呼叫的正常行为onNewIntent(意向)此函数将返回后,您可以自己处理意向。

此函数只能从顶级活动调用;如果是的话从子活动调用时,将引发运行时异常。

参数
意图 开始的意图。
请求代码 如果>=0,此代码将在中返回onActivityResult(),如中所述startActivityForResult(意向,int).
选项 有关如何启动“活动”的其他选项。请参见Context.startActivity(意向,捆绑)了解更多详细信息。
退换商品
  • 如果启动了新活动,则返回true;否则返回false,您必须亲自处理意向。

公众布尔值 启动活动(如果需要) (意图intent,int requestCode)

已在中添加API级别1
参数
意图 开始的意图。
请求代码 如果>=0,则此代码将在onActivityResult(),如中所述startActivityForResult(意向,int).
退换商品
  • 如果启动了新的活动,则返回true;否则返回false,您必须亲自处理意向。

公众空隙 startIntent发送器 (意向发送方意图,意图fillInIntent,int标志掩码,int标志值,int extraFlags,捆绑选项)

已在中添加API级别16
参数
意图 要启动的IntentSender。
填写意向 如果非空,则将作为intent参数到sendIntent(上下文,int,Intent,IntentSender.OnFinished,处理程序).
标志掩码 原始IntentSender中的Intent标志想要改变。
标志值 中设置的任何位的所需值标志掩码
extraFlags(附加标志) 始终设置为0。
选项 有关如何启动“活动”的其他选项。请参见Context.startActivity(意向,捆绑)了解更多详细信息。If选项也由IntentSender提供,此处给出的选项将覆盖任何与意向发送方给出的冲突。

公众空隙 startIntent发送器 (意向发送方意图,意图fillInIntent,int flagsMask,int flagesValues,int extraFlags)

已在中添加API级别5
参数
意图 要启动的IntentSender。
填写意向 如果非空,则将作为intent参数到sendIntent(上下文、int、Intent、IntentSend.OnFinished、处理程序).
标志掩码 原始IntentSender中的Intent标志想要改变。
标志值 中设置的任何位的所需值标志掩码
extra标志 始终设置为0。

公众空隙 startIntentSenderForResult启动意向发送器 (意向发送方intent,int请求代码,意图fillInIntent,int标志掩码,int标志值,int extraFlags,捆绑选项)

已在中添加API级别16

喜欢startActivityForResult(意向,int),但允许你使用IntentSender描述要启动的活动。如果IntentSender用于活动,则该活动将启动就像你打电话给普通人一样startActivityForResult(意向,int)这里;否则,将执行其关联的操作(例如发送广播)就像你打过电话一样意向发送方.sendIntent在上面。

参数
意图 要启动的IntentSender。
请求代码 如果>=0,则此代码将在onActivityResult()。
填写意向 如果非空,则将作为intent参数到sendIntent(上下文,int,Intent,IntentSender.OnFinished,处理程序).
标志掩码 原始IntentSender中的Intent标志想要改变。
标志值 中设置的任何位的所需值标志掩码
extraFlags(附加标志) 始终设置为0。
选项 有关如何启动“活动”的其他选项。请参见Context.startActivity(意向,捆绑)了解更多详细信息。If选项也由IntentSender提供,此处给出的选项将覆盖任何与意向发送方给出的冲突。

公众空隙 startIntentSenderForResult启动意向发送器 (意向发送方intent,int请求代码,意图fillInIntent,int flagsMask,int flagesValues,int extraFlags)

已在中添加API级别5
参数
意图 要启动的IntentSender。
请求代码 如果>=0,则此代码将在onActivityResult()。
填写意向 如果非空,则将作为intent参数到sendIntent(上下文,int,Intent,IntentSender.OnFinished,处理程序).
标志掩码 原始IntentSender中的Intent标志想要改变。
标志值 中设置的任何位的所需值标志掩码
extraFlags(附加标志) 始终设置为0。

公众空隙 startIntentSenderFromChild (活动孩子,意向发送方intent,int请求代码,意图fillInIntent,int flagsMask,int flagesValues,int extraFlags)

已在中添加API级别5

公众空隙 startIntentSenderFromChild (活动孩子,意向发送方intent,int请求代码,意图fillInIntent,int flagsMask,int flagsValues,int extraFlags,捆绑选项)

已在中添加API级别16

公众空隙 启动管理光标 (光标c)

已在中添加API级别1

此方法已弃用API级别11。
使用新的游标加载器与一起上课装载机管理器相反;这也是可通过Android兼容性包在较旧的平台上使用。

此方法允许活动管理给定的光标的生命周期基于活动的生命周期。也就是说,当活动停止时,它将自动调用停用()在给定的游标上,稍后重新启动时它会打电话的重新查询()为你。当活动是销毁后,所有托管游标将自动关闭。如果你的目标是蜂巢或稍后,考虑使用装载机管理器相反,可用通过获取加载器管理器().

警告:不要打电话关闭()在从中获取的游标上managedQuery(Uri,String[],String,String[],String]),因为该活动将在适当的时间为您完成。然而,如果你打电话给stopManagingCursor(光标)在托管查询的游标上,系统不会自动关闭光标,在这种情况下,必须调用关闭().

参数
c(c) 要管理的游标。

公众布尔值 启动下一个匹配活动 (意图意图)

已在中添加API级别1

与呼叫相同startNextMatchingActivity(意向,捆绑包)具有没有选项。

参数
意图 发送到下一个活动的意图。对于正确的行为,这必须与开始的意图相同您自己的活动;你唯一能做的改变就是额外的在里面。
退货
  • 返回一个布尔值,指示是否有其他活动开始:如果有下一个活动要开始,则为true;如果有,则为false不是。一般来说,如果返回true,您会想打电话给自己完成()。

公众布尔值 启动下一个匹配活动 (意图意图,捆绑选项)

已在中添加API级别16

启动活动的特殊版本,用于更换其他活动组件。你可以用这个来传递意图到下一个可以处理它的Activity。通常将其调用为onCreate(捆绑包)意向书由getIntent().

参数
意图 发送到下一个活动的意图。对于正确的行为,这必须与开始的意图相同您自己的活动;你唯一能做的改变就是额外的在里面。
选项 有关如何启动“活动”的其他选项。请参见Context.startActivity(意向,捆绑)了解更多详细信息。
退换商品
  • 返回一个布尔值,指示是否有其他活动开始:如果有下一个活动要开始,则为true;如果有,则为false不是。一般来说,如果返回true,您会想打电话给自己完成()。

公众空隙 启动搜索 (字符串initialQuery,布尔选择initialQuery,捆绑appSearchData,布尔全局搜索)

已在中添加API级别1

调用此挂钩以启动搜索UI。

它通常从onSearchRequested()调用,或者直接从Activity.onSearchRequested()或来自任何给定的重写版本活动。如果您的目标只是激活搜索,最好致电onSearchRequested(),它可能已在“活动”的其他位置被覆盖。如果你的目标是注入特定数据,如上下文数据,首选覆盖onSearchRequested(),这样它的任何调用方都将从重写中受益。

参数
initialQuery(初始化查询) 任何非null非空字符串都将作为搜索查询框中预先输入的文本。
选择InitialQuery 如果为true,将预选初始查询,这意味着任何进一步的键入都会替换它。这对于整个预先形成的正在插入查询。如果为false,则选择点将放置在插入的查询。当插入的查询是用户输入的文本时,这很有用,并且用户期望能够继续打字。此参数仅有意义如果initialQuery是非空字符串。
应用搜索数据 应用程序可以插入特定于应用程序的上下文,以提高其自身的质量或特异性搜索。返回的数据将带有搜索意图。设置为空值不需要额外的数据。
全局搜索 如果为false,则只会启动特定的搜索由应用程序定义(通常定义为本地搜索)。如果没有违约搜索是在当前应用程序或活动中定义的,将启动全局搜索。如果为true,则始终会启动平台全球(例如基于web的)搜索。

公众空隙 停止管理光标 (光标c)

已在中添加API级别1

此方法已弃用API级别11。
使用新的游标加载器与一起上课装载机管理器相反;这也是可通过Android兼容性包在较旧的平台上使用。

给定一个先前指定给的游标startManagingCursor(光标),停止该活动的管理光标。

警告:在对来自托管查询的游标调用此方法之后,系统不会自动关闭光标,您必须调用关闭().

参数
c(c) 正在管理的游标。

公众空隙 takeKeyEvents(获取关键事件) (布尔get)

已在中添加API级别1

要求关键事件参与此活动。如果您的活动没有焦点视图,但活动仍需要处理关键事件的机会。

公众空隙 触发器搜索 (字符串查询,捆绑应用搜索数据)

已在中添加API级别5

类似startSearch(字符串、布尔值、束、布尔值),但实际上在调用后触发搜索查询搜索对话框。用于测试目的。

参数
查询 要触发的查询。如果为空,则忽略该请求。
应用搜索数据 应用程序可以插入特定于应用程序的上下文,以提高其自身的质量或特异性搜索。返回的数据将带有搜索意图。设置为空值不需要额外的数据。

公众空隙 取消注册ContextMenu (查看视图)

已在中添加API级别1

防止为给定视图显示关联菜单。此方法将删除查看。OnCreateContextMenuListener在视图上。

参数
看法 应该停止显示上下文菜单的视图。

受保护的方法

受保护的空隙 onActivityResult(活动结果) (int请求代码,int结果代码,意图数据)

已在中添加API级别1

当您启动的活动退出时调用,为您提供requestCode您启动它时使用的,它返回的resultCode,以及任何其他数据结果代码结果_取消如果活动显式返回,没有返回任何结果,或在操作过程中崩溃。

当您的活动正在重新开始。

参数
请求代码 最初提供给的整数请求代码startActivityForResult(),允许您识别这是谁结果来自。
结果代码 子活动返回的整数结果代码通过其setResult()。
数据 Intent,它可以向调用方返回结果数据(各种数据可附在意向“附加”中)。

受保护的空隙 应用主题资源 (资源。主题主题,int resi,布尔优先)

已在中添加API级别1

由调用集合主题(int)获取主题()应用主题资源添加到当前主题对象。可以重写以更改默认(简单)行为。此方法不会被多次调用同时执行线程。

参数
主题 正在修改的主题对象。
树脂 应用于的主题样式资源主题.
第一 如果这是第一次使用样式,则设置为true应用于主题.

受保护的空隙 onChildTitleChanged (活动子活动,字符序列标题)

已在中添加API级别1

受保护的空隙 创建时的回调函数 (捆绑savedInstanceState)

已在中添加API级别1

在活动开始时调用。这是大多数初始化的地方应该去:呼叫setContentView(int)充气活动的UI,使用按Id查找视图(int)以编程方式进行交互在UI中使用小部件,调用managedQuery(android.net.Uri,String[],String,String[],字符串)检索用于正在显示的数据的光标等。

你可以打电话完成()在此函数中,在在这种情况下,将立即调用onDestroy()活动生命周期的(启动(),onResume(),onPause()等)执行。

派生类必须调用超类的该方法的实现。如果他们不这样做,则会出现例外抛出。

参数
倚仗 如果活动在以下时间后重新初始化之前被关闭,则此捆绑包中包含的数据最多最近在中提供onSaveInstanceState(捆绑包).注:否则为空。

受保护的对话框 在CreateDialog上 (int id)

已在中添加API级别1

此方法已弃用API级别8。
的旧的无参数版本onCreateDialog(int,Bundle).

受保护的对话框 在CreateDialog上 (int id,捆绑参数)

已在中添加API级别8

此方法已弃用API等级13。
使用新的对话框片段与一起上课碎片管理器相反;这也是可通过Android兼容性包在较旧的平台上使用。

用于创建为您管理(保存和恢复)的对话框的回调由活动决定。默认实现调用到onCreateDialog(int)以实现兼容性。如果你的目标是蜂巢或稍后,考虑使用对话框片段相反。

如果您使用showDialog(int),活动将呼叫第一次使用这种方法,然后再使用它。任何对话框由该方法创建的将自动保存和恢复包括它是否正在显示。

如果您希望活动管理保存和恢复对话框对于您来说,应该重写此方法并处理传递给showDialog(int).

如果您希望在显示对话之前有机会准备对话,覆盖onPrepareDialog(int、Dialog、Bundle).

参数
身份证件 对话框的id。
参数 提供给的对话框参数showDialog(int,捆绑).
退换商品
  • 对话框。如果返回null,则不会创建对话框。

受保护的空隙 销毁 ()

已在中添加API级别1

在销毁活动之前执行任何最终清理。这个可以要么是因为活动正在结束(有人打电话给完成()或者因为系统正在暂时破坏此活动实例可节省空间。你可以区分在这两个场景之间使用正在完成()方法。

注意:不要将此方法作为调用的位置正在保存数据!例如,如果活动正在编辑内容中的数据提供程序,这些编辑应提交到onPause()onSaveInstanceState(捆绑包),不是这里。此方法通常用于释放资源,如与活动关联的线程,因此被破坏的活动不会留下这样的东西,而其应用程序的其余部分仍在运行。有些情况下系统将简单地终止活动的托管进程在其中调用此方法(或任何其他方法),因此不应使用它来在流程结束后,做一些打算保留下来的事情离开。

派生类必须调用超类的该方法的实现。如果他们不这样做,则会出现例外抛出。

受保护的空隙 关于NewIntent (意图意图)

已在中添加API级别1

这是为在中将launchMode设置为“singleTop”的活动调用的或者如果客户端使用FLAG_ACTIVITY_SINGLE_TOP标志呼叫时的标志startActivity(目的)。在任何一种情况下,当活动在活动堆栈顶部重新启动对于正在启动的活动的新实例,onNewIntent()将是使用用于的Intent调用现有实例重新启动。

在收到新意图之前,活动将始终暂停,因此你可以指望onResume()在该方法之后被调用。

请注意getIntent()仍然返回原始意图。可以使用setIntent(意向)将其更新为此新意向。

参数
意图 为活动启动的新意图。

受保护的空隙 onPause(暂停) ()

已在中添加API级别1

当活动进入时,作为活动生命周期的一部分调用背景,但尚未被杀死。对应的onResume().

当活动B在活动A之前启动时,此回调将在A上调用。B将在A的onPause()返回,所以一定不要在这里做任何冗长的事情。

此回调主要用于保存活动是编辑,向用户呈现“就地编辑”模型如果没有足够的资源启动,确保没有任何损失没有先杀死这一个的新活动。这也是一件好事放置停止动画和其他消耗用于切换到下一个活动的显著CPU数量尽可能快,或关闭独占访问的资源比如照相机。

在系统需要更多内存的情况下,它可能会终止暂停回收资源的过程。正因为如此,你应该确信到你回来的时候,你所有的州都被拯救了此函数。一般来说onSaveInstanceState(捆绑包)用于保存活动中的per-instance状态,此方法用于存储全局持久数据(在内容提供者、文件等中)

接到此电话后,您通常会接到以下电话onStop()(在恢复下一项活动并显示),但在某些情况下会直接回拨至on继续()而不经历停止状态。

派生类必须调用超类的该方法的实现。如果他们不这样做,则会出现例外抛出。

受保护的空隙 在创建后 (捆绑savedInstanceState)

已在中添加API级别1

活动启动完成时调用(之后启动()onRestoreInstanceState(捆绑包)已被调用)。应用程序将通常不执行此方法;它用于系统类在应用程序代码运行后进行最终初始化。

派生类必须调用到超级类的该方法的实现。如果他们不这样做,则会出现例外抛出。

参数
倚仗 如果活动在以下时间后重新初始化之前被关闭,则此捆绑包中包含的数据最多最近供应于onSaveInstanceState(捆绑包).注:否则为空。

受保护的空隙 在PostResume上 ()

已在中添加API级别1

活动恢复完成时调用(之后onResume()已调用)。应用程序通常不会实现此方法;它用于系统类在应用后进行最终设置恢复代码已运行。

派生类必须调用超类的该方法的实现。如果他们不这样做,则会出现例外抛出。

另请参阅

受保护的空隙 onPrepare对话框 (int id,对话框对话框)

已在中添加API级别1

此方法已弃用API级别8。
旧的无参数版本onPrepareDialog(int、Dialog、Bundle).

受保护的空隙 onPrepare对话框 (int id,对话框对话框,捆绑参数)

已在中添加API级别8

此方法已弃用API等级13。
使用新的对话框片段与一起上课碎片管理器相反;这也是可通过Android兼容性包在较旧的平台上使用。

提供了一个在托管对话开始之前准备它的机会展示。默认实现调用到onPrepareDialog(int,对话框)以实现兼容性。

如果需要基于状态更新托管对话框,请覆盖此选项每次显示应用程序时的。例如,时间选择器对话框可能希望用当前时间更新。你应该打电话到超类的实现。默认实现将此“活动”设置为对话框上的所有者活动。

参数
身份证件 托管对话框的id。
对话 对话框。
参数 提供给的对话框参数showDialog(int,捆绑).

受保护的空隙 重新启动时 ()

已在中添加API级别1

在之后调用onStop()当前活动正在进行时重新显示给用户(用户已经导航回它)。它会的后面跟着启动()然后onResume().

对于使用原始的活动光标对象(而不是通过创建它们managedQuery(android.net.Uri,String[],String,String[],字符串),这里通常是应该重新查询光标的位置(因为您在onStop().

派生类必须调用到超级类的该方法的实现。如果他们不这样做,则会出现例外抛出。

受保护的空隙 onRestoreInstanceState (捆绑savedInstanceState)

已在中添加API级别1

此方法在之后调用启动()当活动是从先前保存的状态重新初始化,如下所示倚仗。大多数实现只需使用onCreate(捆绑包)以恢复其状态,但有时在此处执行此操作很方便在完成所有初始化之后,或者允许子类决定是否使用默认实现。默认值此方法的实现执行以下任何视图状态的恢复之前被冻结onSaveInstanceState(捆绑包).

此方法在启动()onPostCreate(捆绑包).

参数
倚仗 中最近提供的数据onSaveInstanceState(捆绑包).

受保护的空隙 onResume(继续) ()

已在中添加API级别1

在之后调用onRestoreInstanceState(捆绑包),重新启动(),或on暂停(),以便您的活动开始与用户交互。这是一个开始制作动画的好地方,可以打开专用访问设备(如相机)等。

请记住,onResume并不是您活动的最佳指示器对用户可见;系统窗口(如键盘锁)可能位于正面。使用onWindowFocusChanged(布尔值)确信你的活动对用户可见(例如,恢复游戏)。

派生类必须调用超类的该方法的实现。如果他们不这样做,则会出现例外抛出。

受保护的空隙 onSaveInstanceState (捆绑outState)

已在中添加API级别1

调用以在终止之前从活动中检索per-instance状态这样就可以恢复状态onCreate(捆绑包)onRestoreInstanceState(捆绑包)(该捆绑由此方法填充将传递给两者)。

在终止活动之前调用此方法,以便在未来的某个时间回来,它可以恢复其状态。例如,如果活动B在活动A之前启动,并且在某个时间点启动活动A被杀死以回收资源,活动A将有机会保存通过此方法的用户界面的当前状态,以便当用户返回活动A,用户界面的状态可以恢复通过onCreate(捆绑包)onRestoreInstanceState(捆绑包).

不要将此方法与活动生命周期回调混淆,例如onPause(),在放置活动时始终调用在幕后或在走向毁灭的路上,或onStop()哪一个在销毁之前调用。以下是一个例子onPause()onStop()被调用,而不是当用户导航回来时调用此方法从活动B到活动A:无需呼叫onSaveInstanceState(捆绑包)因为该特定实例永远不会恢复,所以系统避免调用它。例如onPause()被称为和onSaveInstanceState(捆绑包)当活动B在活动A之前启动时:系统可能会避免呼叫onSaveInstanceState(捆绑包)在活动A上,如果不是自用户界面状态以来,在B的生存期内被终止A将保持完整。

默认实现负责大多数UI per-instance打电话告诉你onSaveInstanceState()在每个在具有id的层次结构中查看,并通过保存当前聚焦视图(所有这些都通过默认的onRestoreInstanceState(捆绑包)). 如果重写此方法以保存其他没有被每个视图捕获的信息,您可能希望调用默认实现,否则准备保存每个视图的所有状态。

如果调用,此方法将在on停止()。有不能保证它会在之前还是之后发生onPause().

参数
out州 用于放置保存状态的捆绑包。

受保护的空隙 启动时 ()

已在中添加API级别1

在之后调用onCreate(捆绑包)-或之后on重新启动()什么时候活动已停止,但现在再次显示给用户。接下来是onResume().

派生类必须调用超类的该方法的实现。如果他们不这样做,则会出现例外抛出。

受保护的空隙 on停止 ()

已在中添加API级别1

当用户不再看到您时调用。你将是下一个接收其中之一重新启动(),onDestroy()或者什么都没有,这取决于以后的用户活动。

注意,在内存不足的情况下,可能永远不会调用此方法系统没有足够的内存来保存您的活动在其之后运行的进程onPause()方法。

派生类必须调用超类的该方法的实现。如果他们不这样做,则会出现例外抛出。

受保护的空隙 onTitleChanged(标题已更改) (字符序列标题,int颜色)

已在中添加API级别1

受保护的空隙 onUserLeaveHint(用户离开提示) ()

已在中添加API级别3

当活动即将开始时,作为活动生命周期的一部分调用作为用户选择的结果进入后台。例如,当用户按下Home键,onUserLeaveHint()将被调用,但当来电导致通话中的“活动”自动带到前台,onUserLeaveHint()不会被调用活动被中断。在调用时,此方法在活动之前调用onPause()回调。

此回调和on用户交互()旨在提供帮助活动智能地管理状态栏通知;明确地,帮助活动确定取消通知的适当时间。