到顶部
Android API
公众的接口

菜单

android.view。菜单
已知间接子类

课程概述

用于管理菜单中项目的界面。

默认情况下,每个“活动”都支持操作或选项的选项菜单。您可以将项目添加到此菜单,并处理对添加内容的单击。这个添加菜单项的最简单方法是将XML文件膨胀到菜单通过菜单充气器。将代码附加到的最简单方法点击是通过onOptionsItemSelected(菜单项)onContextItemSelected(菜单项).

不同的菜单类型支持不同的功能:

  1. 上下文菜单:不支持项目快捷方式和项目图标。
  2. 选项菜单:该图标菜单不支持项目检查标记并仅显示项目的简明标题. The展开的菜单(仅当六个或更多菜单项可见时可用,通过图标菜单中的“更多”项目访问)不显示项目图标,并且不鼓励使用项目复选标记。
  3. 子菜单:不支持项目图标或嵌套子菜单。

开发人员指南

有关创建菜单的更多信息,请阅读菜单开发人员指南。

总结

常量
整数 类别_长期 以下项目/组的订单整数的类别代码对当前显示的数据的替代操作--或/add这是你的基本价值。
整数 类别_容器 属于容器--或/将其与基本值相加。
整数 类别_次要 以下项目/组的订单整数的类别代码用户提供的辅助(不常用)选项--或/使用你的基本价值。
整数 类别_系统 由提供的项目/组的订单整数的类别代码系统——或将其与基本值相加。
整数 第一 组和项标识符整数的第一个值。
整数 FLAG_ALWAYS_性能_关闭 的标志performShortcut(int,KeyEvent,int):如果设置,则始终执行快捷方式后关闭菜单。
整数 标志_附件_TO_组 的标志addIntentOptions(int,int,int、ComponentName、Intent[]、Intent、int、MenuItem[]):如果设置,则不自动删除同一组中的任何现有菜单项。
整数 标志_性能_关闭 的标志performShortcut(int,KeyEvent,int):如果设置,请勿在执行快捷方式。
整数 不关心时用于组和项目标识符整数的值关于他们。
公共方法
摘要菜单项 添加(字符序列标题)
向菜单添加新项。
摘要菜单项 添加(int groupId,int itemId,int order,int titleRes)
上的变化添加(int,int,int、CharSequence)这需要一个字符串资源标识符,而不是字符串本身。
摘要菜单项 添加(int titleRes)
向菜单添加新项。
摘要菜单项 添加(int groupId,int itemId,int order,int顺序,字符序列标题)
向菜单添加新项。
摘要整数 添加意向选项(int groupId,int itemId,int order,int顺序,组件名称呼叫方,意向[]细节,意图intent,int标志,菜单项[]outSpecificItems)
添加一组与可以执行的操作相对应的菜单项用于特定目的。
摘要子菜单 添加子菜单(int groupId,int itemId,int order,int顺序,字符序列标题)
将新的子菜单添加到菜单中。
摘要子菜单 添加子菜单(int groupId,int itemId,int order,int titleRes)
上的变化addSubMenu(int、int、int和CharSequence)这需要标题的字符串资源标识符,而不是字符串本身。
摘要子菜单 添加子菜单(字符序列标题)
将新的子菜单添加到菜单中。
摘要子菜单 添加子菜单(int titleRes)
将新的子菜单添加到菜单中。
摘要空隙 清楚的()
从菜单中删除所有现有项,使其为空刚刚创建。
摘要空隙 关闭()
关闭菜单(如果打开)。
摘要菜单项 查找项目(int id)
返回具有特定标识符的菜单项。
摘要菜单项 获取项目(int索引)
获取给定索引处的菜单项。
摘要布尔值 有可见项()
返回菜单当前是否有可见的项目项。
摘要布尔值 是快捷键(int keyCode,键盘事件事件)
按键是为此窗口定义的快捷键之一。
摘要布尔值 执行标识符操作(int id,int标志)
执行与给定菜单标识符关联的菜单项操作。
摘要布尔值 执行快捷方式(int keyCode,键盘事件事件,int标志)
执行与给定快捷方式关联的菜单项操作字符。
摘要空隙 删除组(int组ID)
删除给定组中的所有项目。
摘要空隙 删除项目(int id)
删除具有给定标识符的项。
摘要空隙 设置可检查组(int组,布尔值可检查,布尔值不包括)
控制特定项组是否可以显示复选标记。
摘要空隙 设置组已启用(int组,启用布尔值)
启用或禁用给定组中的所有菜单项。
摘要空隙 设置可见组(int组,布尔可见)
显示或隐藏给定组中的所有菜单项。
摘要空隙 设置QwertyMode(布尔值isQwerty)
控制菜单是否应在qwerty模式下运行(字母快捷键)或12键模式(数字快捷键)。
摘要整数 大小()
获取菜单中的项目数。

常量

公众静态最终的整数类别_长期

以下项目/组的订单整数的类别代码对当前显示的数据的替代操作--或/add这是你的基本价值。

常量值: 262144(0x00040000)

公众静态最终的整数类别_容器

属于容器--或/将其与基本值相加。

常量值: 65536(0x00010000)

公众静态最终的整数类别_次要

以下项目/组的订单整数的类别代码用户提供的辅助(不常用)选项--或/使用你的基本价值。

常量值: 196608(0x00030000)

公众静态最终的整数类别_系统

由提供的项目/组的订单整数的类别代码系统——或将其与基本值相加。

常量值: 131072(0x00020000)

公众静态最终的整数第一

组和项标识符整数的第一个值。

常量值: 1(0x00000001)

公众静态最终的整数FLAG_ALWAYS_性能_关闭

的标志performShortcut(int,KeyEvent,int):如果设置,则始终执行快捷方式后关闭菜单。关闭菜单也会重置准备状态。

常量值: 2(0x00000002)

公众静态最终的整数标志_附件_TO_组

的标志addIntentOptions(int,int,int、ComponentName、Intent[]、Intent、int、MenuItem[]):如果设置,则不自动删除同一组中的任何现有菜单项。

常量值: 1(0x00000001)

公众静态最终的整数标志_性能_关闭

的标志performShortcut(int,KeyEvent,int):如果已设置,则在之后不要关闭菜单执行快捷方式。

常量值: 1(0x00000001)

公众静态最终的整数

当您不关心时,用于组和项标识符整数的值关于他们。

常量值: 0(0x00000000)

公共方法

公众摘要菜单项 添加 (字符序列标题)

向菜单添加新项。此项目显示其给定标题标签。

参数
标题 要为项显示的文本。
退换商品
  • 新添加的菜单项。

公众摘要菜单项 添加 (int groupId,int itemId,int order,int titleRes)

上的变化添加(int,int,int、CharSequence)这需要一个字符串资源标识符而不是字符串本身。

参数
组Id 此项应属于的组标识符。这也可以用于定义批状态的项目组变化。正常使用如果项目不应位于组。
项目ID 唯一项目ID使用如果您不需要唯一ID。
秩序 项目的顺序。使用如果你不在乎关于订单。请参见获取订单().
titleRes公司 标题字符串的资源标识符。
退换商品
  • 新添加的菜单项。

公众摘要菜单项 添加 (int titleRes)

向菜单添加新项。此项目显示其给定标题标签。

参数
titleRes公司 标题字符串的资源标识符。
退换商品
  • 新添加的菜单项。

公众摘要菜单项 添加 (int groupId,int itemId,int order,int顺序,字符序列标题)

向菜单添加新项。此项目显示其给定标题标签。

参数
组Id 此项目应属于的组标识符。这可用于定义批处理状态的项目组变化。正常使用如果项目不应位于组。
项目ID 唯一项目ID使用如果您不需要唯一ID。
秩序 项目的顺序。使用如果你不在乎关于订单。请参见获取订单().
标题 要为项显示的文本。
退换商品
  • 新添加的菜单项。

公众摘要整数 添加意向选项 (int groupId,int itemId,int order,int顺序,组件名称呼叫方,意向[]细节,意图intent,int标志,菜单项[]outSpecificItems)

添加一组与可以执行的操作相对应的菜单项用于特定目的。Intent通常配置为null操作,当前活动正在处理的数据,包括要么是类别_长期类别_选定_备选查找具有以下特征的活动说他们希望被列为可选行动。然而,你可以,使用任何你想要的意图。

请参见queryIntentActivityOptions(组件名称,Intent[],Intent,int)有关呼叫者,细节、和意图论据。使用该函数返回的列表填充生成的菜单项。

将添加所有可能选项的菜单项使用给定的组和id。可以使用组控制与菜单中其他项目相关的项目。通常此功能将自动删除菜单中的任何现有项目将添加的项目分组并在其上方和下方放置分隔符;这种行为可以使用修改旗帜参数。对于每个生成的项目setIntent(意向)调用以关联项目的适当意图;这意味着活动将自动为您启动,无需执行任何其他操作。

参数
组Id 项目应属于的组标识符。这也可以用于定义批状态的项目组变化。正常使用如果项目不应在一个小组。
项目ID 唯一项目ID使用如果您不需要唯一ID。
秩序 项目的顺序。使用如果你不这样做关注订单。请参见获取订单().
呼叫者 由定义的当前活动组件名称queryIntentActivityOptions()。
细节 根据定义,首先放置的特定项目queryIntentActivityOptions()。
意图 描述要填充到由queryIntentActivityOptions()定义的列表。
旗帜 控制如何添加项目的其他选项。
输出特定项目 放置菜单项的可选数组为每个细节那是请求。如果找不到活动,则条目可能为空具体行动。
退换商品
  • 添加的菜单项数。

公众摘要子菜单 添加子菜单 (int groupId,int itemId,int order,int顺序,字符序列标题)

将新的子菜单添加到菜单中。此项目显示给定的标题用于其标签。要修改子菜单的菜单项,使用获取项目().

请注意,您只能有一级子菜单,即不能添加子菜单到子菜单:不支持的操作异常如果你试着扔。

参数
组Id 此项应属于的组标识符。这也可以用于定义批状态的项目组变化。正常使用如果项目不应位于组。
项目ID 唯一项目ID使用如果您不需要唯一ID。
秩序 项目的顺序。使用如果你不在乎关于订单。请参见获取订单().
标题 要为项显示的文本。
退换商品
  • 新增子菜单

公众摘要子菜单 添加子菜单 (int groupId,int itemId,int order,int titleRes)

上的变化addSubMenu(int、int、int和CharSequence)这需要标题的字符串资源标识符,而不是字符串本身。

参数
组Id 此项应属于的组标识符。这也可以用于定义批状态的项目组变化。正常使用如果一个项目不应该在一个组中。
项目ID 唯一项目ID使用如果您不需要唯一的ID。
秩序 项目的顺序。使用如果你不在乎订单。请参见获取订单().
titleRes公司 标题字符串的资源标识符。
退换商品
  • 新增子菜单

公众摘要子菜单 添加子菜单 (字符序列标题)

将新的子菜单添加到菜单中。此项显示的给定标题它的标签。要修改子菜单菜单项上的其他属性,请使用获取项目().

参数
标题 要为项显示的文本。
退换商品
  • 新增子菜单

公众摘要子菜单 添加子菜单 (int titleRes)

将新的子菜单添加到菜单中。此项显示的给定标题它的标签。要修改子菜单菜单项上的其他属性,请使用获取项目().

参数
titleRes公司 标题字符串的资源标识符。
退换商品
  • 新增子菜单

公众摘要空隙 清楚的 ()

从菜单中删除所有现有项,使其为空刚刚创建。

公众摘要空隙 关闭 ()

已在中添加API级别3

关闭菜单(如果打开)。

公众摘要菜单项 查找项目 (int id)

返回带有特定标识符的菜单项。

参数
身份证件 要查找的标识符。
退换商品
  • 菜单项对象,如果没有带此标识符。

公众摘要菜单项 获取项目 (int索引)

已在中添加API级别3

获取给定索引处的菜单项。

参数
指数 要返回的菜单项的索引。
退换商品
  • 菜单项。
投掷
索引超出边界异常 什么时候索引=size()

公众摘要布尔值 有可见项 ()

返回菜单当前是否有可见的项目项。

退换商品
  • 如果有一个或多个项目可见,则为True,否则为false。

公众摘要布尔值 是快捷键 (int keyCode,键盘事件事件)

按键是为此窗口定义的快捷键之一。

参数
keyCode(密钥代码) 来自的密钥代码键盘事件进行检查。
事件 这个键盘事件用于帮助检查。

公众摘要布尔值 执行标识符操作 (int id,int标志)

执行与给定菜单标识符关联的菜单项操作。

参数
身份证件 与菜单项关联的标识符。
旗帜 其他选项标志或0。
退换商品
  • 如果给定的标识符存在并显示,则返回真;否则返回false。
另请参见

公众摘要布尔值 执行快捷方式 (int keyCode,键盘事件事件,int标志)

执行与给定快捷方式关联的菜单项操作字符。

参数
keyCode(密钥代码) 快捷键的键码。
事件 关键事件消息。
旗帜 其他选项标志或0。
退换商品
  • 如果给定的快捷方式存在并显示,则返回真;否则返回false。
另请参见

公众摘要空隙 删除组 (int组ID)

删除给定组中的所有项目。

参数
组Id 要删除的组。如果此中没有项目小组,什么都没发生。

公众摘要空隙 删除项目 (int id)

删除具有给定标识符的项。

参数
身份证件 要删除的项目。如果没有此项标识符,什么都没有发生。

公众摘要空隙 设置组可检查 (int组,布尔值可检查,布尔值不包括)

控制特定项组是否可以显示复选标记。此类似于调用setCheckable(布尔值)在所有菜单项上使用给定的组标识符,但除此之外,您可以控制是否此组包含相互排斥的集合项目。这应该叫组中的项目添加到菜单后。

参数
要操作的项组。
可检查的 设置为true允许复选标记,设置为false不允许。默认值为false。
排他性的 如果设置为true,则此组中只能有一项一次检查;检查一个项目将自动取消选中组中的所有其他项。如果设置为false,则每个项目可以独立于其他项目进行检查。

公众摘要空隙 设置组已启用 (int组,启用布尔值)

启用或禁用给定组中的所有菜单项。

参数
要操作的项组。
启用 如果为true,则将启用这些项,否则将禁用它们。

公众摘要空隙 设置可见组 (int组,布尔可见)

显示或隐藏给定组中的所有菜单项。

参数
要操作的项目组。
看得见的 如果为true,则项目可见,否则将隐藏。

公众摘要空隙 设置QwertyMode (布尔值isQwerty)

控制菜单是否应在qwerty模式下运行(字母快捷键)或12键模式(数字快捷键)。

参数
isQ功率 如果为true,菜单将使用字母快捷键;否则它将使用数字快捷方式。

公众摘要整数 大小 ()

获取菜单中的项目数。请注意,这将更改任何在菜单中添加或删除项目的时间。

退换商品
  • 项目计数。