到顶部
Android API
java.lang.Object(java.lang.对象)
android应用程序。浮动搜索框

课程概述

此类提供对系统搜索服务的访问。

实际上,您不会直接与这个类交互,因为搜索服务是通过中的方法提供的活动以及操作_搜索 意图如果您确实需要直接访问SearchManager,请不要实例化这个类直接。相反,通过检索context.getSystemService(context.SEARCH_SERVICE)

开发人员指南

有关使用搜索对话框和添加搜索的详细信息应用程序中的建议,请阅读搜索开发人员指南。

总结

内部类
接口 搜索管理器。OnCancelListener 请参见setOnCancelListener(SearchManager.OnCancelListener)用于配置要监视的活动搜索UI状态。 
接口 搜索管理器。OnDismissListener 请参见setOnDismissListener(SearchManager.OnDismiss Listener)用于配置要监视的活动搜索UI状态。 
常量
字符串 动作_键 Intent额外的数据键:将此键与Intent一起使用。ACTION_SEARCH和内容。意向.getIntExtra()以获取用户用于触发此查询的密钥码。
字符串 动作_MSG Intent额外的数据键:将此键与Intent一起使用。ACTION_SEARCH和内容。Intent.getStringExtra()获取为特定搜索操作键定义的操作消息和/或建议。
字符串 应用数据 Intent额外的数据键:将此键与Intent一起使用。ACTION_SEARCH和内容。Intent.getBundleExtra()获取由启动搜索的活动。
字符串 光标_外置_按键_进程 建议提供程序返回的布尔额外数据键获取附加功能()表示搜索尚未完成。
字符串 额外数据密钥 意向额外数据键:此键将用于由建议_COLUMN_INTENT_EXTRA_DATA列。
字符串 额外_新_搜索 的布尔额外数据键动作_刹车_搜索意图。
字符串 额外选择查询 的布尔额外数据键INTENT_ACTION_GLOBAL_SEARCH(意图_操作_全局_搜索)意图。
字符串 EXTRA_WEB_SEARCH_PENDINGINTENT额外_学习_结束 的额外数据键动作_刹车_搜索
整数 标志_查询_定义 用于指定条目可用于查询优化的标志,即查询文本当查询细化时,可以用此条目中的文本替换搜索字段中的图标被单击。
字符串 INTENT_ACTION_GLOBAL_SEARCH(意图_操作_全局_搜索) 启动全局搜索活动的意向操作。
字符串 意图_操作_搜索_更改 播放意图操作以通知可搜索列表或默认值已更改。
字符串 意图_操作_搜索_设置 启动全局搜索设置活动的意向操作。
字符串 意图_操作_搜索_设置_更改 播放意图操作以通知搜索设置已以某种方式更改。
字符串 意图_操作_WEB_SEARCH_SETTINGS 用于启动web搜索提供程序的设置活动的意向操作。
字符串 意向_全局_搜索_活动_更改 打算广播行动,告知全球搜索提供商已经发生了变化。
烧焦 菜单_键 这是用于调用搜索的默认菜单键的快捷定义。
整数 菜单_键盘 这是用于调用搜索的默认菜单键的快捷定义。
字符串 查询 意向额外数据密钥:将此密钥与一起使用内容。Intent.getStringExtra()以从Intent中获取查询字符串。行动_搜索。
字符串 快捷方式_时间_类型 用于快捷方式验证的MIME类型。
字符串 建议_列_标志 建议光标的列名。
字符串 建议_列_格式 建议光标的列名。
字符串 建议_ COLUMN_ICON_1 建议光标的列名。
字符串 建议_ COLUMN_ICON_2 建议光标的列名。
字符串 建议_COLUMN_INT_ACTION 建议光标的列名。
字符串 建议_COLUMN_INT_DATA 建议光标的列名。
字符串 建议_COLUMN_INT_DATA_ID 建议光标的列名。
字符串 建议_COLUMN_INTENT_EXTRA_DATA 建议光标的列名。
字符串 建议_COLUMN_LAST_ACCESS_HINT 建议光标的列名。
字符串 建议_列_查询 建议光标的列名。
字符串 建议_COLUMN_SHORTCUT_ID 建议光标的列名。
字符串 建议_COLUMN_SPINNER_WHILE_REFRESHING 建议光标的列名。
字符串 建议_COLUMN_TEXT_1 建议光标的列名。
字符串 建议_列_文本2 建议光标的列名。
字符串 建议_COLUMN_TEXT_2_URL 建议光标的列名。
字符串 建议_时间_类型 建议数据的MIME类型。
字符串 建议_从不_标记_快捷方式 建议列的列值建议_列_捷径_ID当一个建议不应在全局搜索中存储为快捷方式。
字符串 建议_PARAMETER_LIMIT 向建议查询添加了查询参数,以限制返回的建议数。
字符串 建议_URI_PATH_QUERY 查询的建议数据的Uri路径。
字符串 建议_URI_PATH_SHORTCUT 快捷方式验证的Uri路径。
字符串 用户查询(_Q) 意向额外数据密钥:将此密钥与一起使用内容。Intent.getStringExtra()以获取用户键入的查询字符串。
公共方法
组件名称 获取全球搜索活动()
获取全局搜索活动的名称。
可搜索信息 获取可搜索信息(组件名称组件名称)
获取有关可搜索活动的信息。
列表<可搜索信息> 在全局搜索中获取搜索项()
返回可包含在全局搜索中的可搜索活动的列表。
空隙 onCancel(取消)(对话框界面对话框)
此方法已弃用API级别4。此方法是过时的内部实现细节。不要使用。
空隙 onDismiss(开除)(对话框界面对话框)
此方法已被弃用API级别4。此方法是过时的内部实现细节。不要使用。
空隙 设置取消侦听器(搜索管理器。OnCancelListener监听器)
设置或清除在取消搜索UI时将调用的回调。
空隙 设置OnDismissListener(搜索管理器。OnDismissListener监听器)
设置或清除在关闭搜索UI时将调用的回调。
空隙 启动搜索(字符串initialQuery,布尔选择initialQuery,组件名称启动活动,捆绑appSearchData,布尔全局搜索)
启动搜索UI。
空隙 停止搜索()
终止搜索UI。
空隙 触发器搜索(字符串查询,组件名称启动活动,捆绑应用搜索数据)
类似startSearch(字符串、布尔值、组件名称、束、布尔值)但实际上在调用后触发搜索查询搜索对话框。
[展开]
继承的方法
来自班级java.lang.Object(java.lang.对象)
来自接口android内容。对话框界面。OnCancelListener
来自接口android内容。对话框界面。OnDismissListener

常量

公众静态的最终的字符串 动作_键

已在中添加API级别1

Intent额外的数据键:将此键与Intent一起使用。ACTION_SEARCH和内容。意向.getIntExtra()以获取用户用于触发此查询的密钥码。如果用户只需按下搜索UI上的“GO”按钮。这主要与在searchable.xml配置的actionkey元素中使用keycode属性文件。

常量值: “操作密钥”

公众静态的最终的字符串 动作_MSG

已在中添加API级别1

Intent额外的数据键:将此键与Intent一起使用。ACTION_SEARCH和内容。Intent.getStringExtra()获取为特定搜索操作键定义的操作消息和/或建议。如果搜索是通过键入“enter”启动的,触按“GO”按钮,或其他不涉及任何操作键的方式。

常量值: “action_msg”

公众静态的最终的字符串 应用数据

已在中添加API级别1

Intent额外数据密钥:将此密钥与Intent一起使用。ACTION_SEARCH和内容。Intent.getBundleExtra()获取由启动搜索的活动。

常量值: “应用数据”

公众静态的最终的字符串 光标_外置_按键_进程

已在中添加API级别8

建议提供程序返回的布尔额外数据键获取附加功能()表示搜索尚未完成。这可以由搜索UI使用以指示搜索正在进行。建议提供者可以返回部分结果这样,当有更多结果可用时,在光标上发送更改通知。

常量值: “正在进行”

公众静态的最终的字符串 额外_ ATA_键

已在中添加API级别4

意向额外数据键:此键将用于由建议_COLUMN_INTENT_EXTRA_DATA列。

常量值: “intent_extra_data_key”

公众静态的最终的字符串 额外_新_搜索

已在中添加API级别12

的布尔额外数据键动作_刹车_搜索意图。如果真的,此搜索应该打开一个新的浏览器窗口,而不是使用现有的窗口。

常量值: “新搜索”

公众静态的最终的字符串 额外选择查询

已在中添加API级别8

的布尔额外数据键INTENT_ACTION_GLOBAL_SEARCH(意图_操作_全局_搜索)意图。如果真的,初始查询应该在全局搜索活动启动时选择,因此用户可以轻松地将其替换为另一个查询。

常量值: “选择查询”

公众静态的最终的字符串 EXTRA_WEB_SEARCH_PENDINGINTENT额外_学习_结束

已在中添加API级别14

的额外数据键动作_刹车_搜索。如果设置,值必须是处理意图。处理动作_刹车_搜索intent将填充并启动待定的intent。数据URI将使用http或https URI,以及其他页眉(_H)可以填写。

常量值: “web_search_pendingcontent”

公众静态的最终整数标志_查询_定义

已在中添加API级别11

用于指定条目可用于查询优化的标志,即查询文本当查询细化时,可以用此条目中的文本替换搜索字段中的图标被单击。建议列表应该在条目旁边显示这样一个可单击的图标。

将此标志用作建议_列_标志

常量值: 1(0x00000001)

公众静态的最终的字符串 INTENT_ACTION_GLOBAL_SEARCH(意图_操作_全局_搜索)

已在中添加API级别8

启动全局搜索活动的意向操作。全球搜索提供商应处理此意图。支持的额外数据键:查询,额外选择查询,应用数据

常量值: “android.search.action.GLOBAL_search”

公众静态的最终的字符串 意图_操作_搜索_更改

已在中添加API级别4

播放意图操作以通知可搜索列表或默认值已更改。如果组件缓存任何可搜索数据并希望保留,则应处理此意图最新的变更。

常量值: “android.search.action.SEARCHABLES_CHANGED”

公众静态的最终的字符串 意图_操作_搜索_设置

已在中添加API级别8

用于启动全局搜索设置活动的意向操作。全球搜索提供商应处理此意图。

常量值: “android.search.action.search_SETTINGS”

公众静态的最终的字符串 意图_操作_搜索_设置_更改

已在中添加API级别4

播放意图操作以通知搜索设置已以某种方式更改。已启用或禁用搜索项,或者其他web搜索提供商已被选中。

常量值: “android.search.action.SETTINGS_CHANGED”

公众静态的最终的字符串 意图_操作_WEB_SEARCH_SETTINGS

已在中添加API级别4

启动web搜索提供商设置活动的意向操作。如果Web搜索提供商具有特定于提供商的功能,则应处理此意图要实现的设置。

常量值: “android.search.action.WEB_search_SETTINGS”

公众静态的最终的字符串 意向_全局_搜索_活动_更改

已在中添加API级别16

打算广播行动,告知全球搜索提供商已更改。

常量值: “android.search.action.GLOBAL_search_ACTIVITY_CHANGED”

公众静态的最终烧焦菜单_键

已在中添加API级别1

这是用于调用搜索的默认菜单键的快捷定义。请参见菜单。Item.setAlphabeticShortcut()了解更多信息。

常量值: 115(0x00000073)

公众静态的最终整数菜单_键盘

已在中添加API级别1

这是用于调用搜索的默认菜单键的快捷定义。请参见菜单。Item.setAlphabeticShortcut()了解更多信息。

常量值: 47(0x0000002f)

公众静态的最终的字符串 查询

已在中添加API级别1

意向额外数据密钥:将此密钥与一起使用内容。Intent.getStringExtra()从Intent获取查询字符串。行动_搜索。

常量值: “查询”

公众静态的最终的字符串 SHORTCUT_MIME_TYPE(时间类型)

已在中添加API级别4

用于快捷方式验证的MIME类型。您将在建议内容提供商中使用此内容在getType()函数中。

常量值: “vnd.android.cursor.item/vnd.addroid.search.support”

公众静态的最终的字符串 建议_列_标志

已在中添加API级别11

建议光标的列名。可选。此列用于指定每个项目的附加标志。可以指定多个标志。

必须是其中之一标志_查询_定义或0表示没有标志。

常量值: “建议标志”

公众静态的最终的字符串 建议_列_格式

已在中添加API级别1

建议光标的列名。未使用-可以为空,也可以省略列。

常量值: “建议格式”

公众静态的最终的字符串 建议_ COLUMN_ICON_1

已在中添加API级别1

建议光标的列名。可选。如果光标包含此列,然后,所有建议都将以包含两个小图标空间的格式提供,每个建议左边一个,右边一个。列中的数据必须是可绘制的资源ID,或以下格式之一的URI:

请参见openAssetFileDescriptor(Uri,字符串)有关这些方案的更多信息。

常量值: “建议_icon_1”

公众静态的最终的字符串 建议_ COLUMN_ICON_2

已在中添加API级别1

建议光标的列名。可选。如果光标包含此列,然后,所有建议都将以包含两个小图标空间的格式提供,每个建议左边一个,右边一个。列中的数据必须是可绘制的资源ID,或以下格式之一的URI:

请参见openAssetFileDescriptor(Uri,字符串)有关这些方案的更多信息。

常量值: “建议_icon_2”

公众静态的最终的字符串 建议_COLUMN_INT_ACTION

已在中添加API级别1

建议光标的列名。可选。如果此列存在此元素存在于给定的行中,这是将在以下情况下使用的操作形成建议的意图。如果未提供元素,将采取操作来自XML元数据中的android:searchSuggestIntentAction字段。至少一个这些必须存在,建议才能产生意图。注意:如果您的操作是对于所有建议都是一样的,使用XML元数据指定它并省略它更有效它来自光标。

常量值: “建议_注意_操作”

公众静态的最终的字符串 建议_COLUMN_INT_DATA

已在中添加API级别1

建议光标的列名。可选。如果此列存在此元素存在于给定的行中,这是将在以下情况下使用的数据形成建议的意图。如果未提供元素,则将获取数据来自XML元数据中的android:searchSuggestIntentData字段。如果两个来源都没有则Intent的数据字段将为空。注意:如果您的数据是所有建议都是相同的,或者可以使用常量部分和特定ID进行描述,使用XML元数据指定它并从游标中省略它更有效。

常量值: “建议_通知_数据”

公众静态的最终的字符串 建议_COLUMN_INT_DATA_ID

已在中添加API级别1

建议光标的列名。可选。如果此列存在该元素存在于给定的行中,然后是“/”,该值将附加到数据中意向中的字段。只有在数据字段已设置为适当的基本字符串。

常量值: “suggest_intent_data_id”

公众静态的最终的字符串 建议_COLUMN_INTENT_EXTRA_DATA

已在中添加API级别4

建议光标的列名。可选。如果此列存在此元素存在于给定的行中,这是将在以下情况下使用的数据形成建议的意图。如果未提供,则Intent的额外数据字段将为空。此列允许建议提供附加的任意数据,这些数据将作为钥匙下面有一个额外的额外_ ATA_键

常量值: “建议删除额外数据”

公众静态的最终的字符串 建议_COLUMN_LAST_ACCESS_HINT

已在中添加API级别14

建议光标的列名。可选。此列可能是用于指定时间系统当前TImeMillis()(UTC的墙时)项目最后一次出现的时间在结果提供应用程序中访问。如果设置,这可能是用于首先显示最近使用的项目。

常量值: “suggest_last_access_hint”

公众静态的最终的字符串 建议_列_查询

已在中添加API级别1

建议光标的列名。如果操作是必需的操作_搜索,否则可选。如果是这样列已存在此元素存在于给定的行中,这是将形成建议查询时使用。

常量值: “建议_通知_查询”

公众静态的最终的字符串 建议_COLUMN_SHORTCUT_ID

已在中添加API级别4

建议光标的列名。可选。此列用于指示是否搜索建议应该作为快捷方式存储,以及是否应该刷新。如果如果缺少,结果将存储为快捷方式,并且永远不会验证。如果设置为建议_从不_标记_快捷方式,结果将不会作为快捷方式存储。否则,快捷方式id将用于使用检查最新建议建议_URI_PATH_SHORTCUT

常量值: “建议_快捷方式_id”

公众静态的最终的字符串 建议_COLUMN_SPINNER_WHILE_REFRESHING

已在中添加API级别4

建议光标的列名。可选。此列用于指定应该显示一个微调器来代替图标2,而这个建议的快捷方式正在刷新。

常量值: “建议spiner_while_refreshing”

公众静态的最终的字符串 建议_COLUMN_TEXT_1

已在中添加API级别1

建议光标的列名。必修的。这是文本的主要行将作为建议提交给用户。

常量值: “建议文本_1”

公众静态的最终的字符串 建议_COLUMN_TEXT_2

已在中添加API级别1

建议光标的列名。可选。如果光标包含此列,然后,所有建议将以两行格式提供。第二行文本位于小得多的外观。

常量值: “建议文本_2”

公众静态的最终的字符串 建议_COLUMN_TEXT_2_URL

已在中添加API级别8

建议光标的列名。可选。这是将显示的URL作为第二行文本,而不是建议_COLUMN_TEXT_2。这是一个单独的列,以便搜索UI知道将文本显示为URL,例如通过使用不同的颜色。如果此列不存在,或具有值无效的,建议_COLUMN_TEXT_2将被使用。

常量值: “建议文本2_url”

公众静态的最终的字符串 建议_时间_类型

已在中添加API级别1

建议数据的MIME类型。您将在建议内容提供商中使用此选项在getType()函数中。

常量值: “vnd.android.cursor.dir/vnd.android.search.s建议”

公众静态的最终的字符串 建议_从不_标记_快捷方式

已在中添加API级别4

建议列的列值建议_COLUMN_SHORTCUT_ID当一个建议不应在全局搜索中存储为快捷方式。

常量值: "_-1"

公众静态的最终的字符串 建议参数限制

已在中添加API级别5

向建议查询添加了查询参数,以限制返回的建议数。只有咨询和建议提供者可能会选择忽略此限制。

常量值: “限制”

公众静态的最终的字符串 建议_URI_PATH_QUERY

已在中添加API级别1

查询的建议数据的Uri路径。这是搜索管理器根据用户输入向内容提供商查询建议数据时将使用(例如,查找部分匹配项)。通常,您会将其与URI匹配器一起使用。

常量值: “搜索建议查询”

公众静态的最终的字符串 建议_URI_PATH_SHORTCUT

已在中添加API级别4

快捷方式验证的Uri路径。这是搜索管理器在以下情况下使用的路径查询内容提供商以刷新快捷建议结果并检查它是否仍然有效。当被询问时,源可能会返回最新的结果,或者没有结果。结果表明快捷方式引用了不再有效的建议。

常量值: “搜索建议快捷方式”

公众静态的最终的字符串 用户查询(_Q)

已在中添加API级别4

意向额外数据密钥:将此密钥与一起使用内容。Intent.getStringExtra()以获取用户键入的查询字符串。这可能与查询如果意图是选择建议的结果。在这种情况下,查询将包含的值建议列查询建议,以及用户查询(_Q)将包含由用户。

常量值: “用户查询”

公共方法

公众的组件名称 获取全球搜索活动 ()

已在中添加API级别16

获取全局搜索活动的名称。

公众的可搜索信息 获取可搜索信息 (组件名称组件名称)

已在中添加API级别8

获取有关可搜索活动的信息。

参数
组件名称 获取可搜索信息的活动。
退换商品
  • 可搜索信息,或无效的如果活动没有存在,或不可搜索。

公众的列表<可搜索信息> 在全局搜索中获取搜索项 ()

已在中添加API级别8

返回可包含在全局搜索中的可搜索活动的列表。

退换商品
  • 包含所有可搜索活动的可搜索信息的列表android:includeInGlobalSearch属性集在他们可搜索的元数据中。

公众空隙 onCancel(取消) (对话框界面对话框)

已在中添加API级别1

此方法已弃用API级别4。
此方法是过时的内部实现细节。不要使用。

取消对话框时将调用此方法。

参数
对话 取消的对话框将传递到方法。

公众空隙 onDismiss(开除) (对话框界面对话框)

已在中添加API级别1

此方法已弃用API级别4。
此方法是过时的内部实现细节。不要使用。

当对话框关闭时,将调用此方法。

参数
对话 被取消的对话框将被传递到方法。

公众空隙 设置OnCancelListener (搜索管理器。OnCancelListener监听器)

已在中添加API级别1

设置或清除每当取消搜索UI时将调用的回调。

参数
听众 这个搜索管理器。OnCancelListener使用,或为空。

公众空隙 设置OnDismissListener (搜索管理器。OnDismissListener监听器)

已在中添加API级别1

设置或清除在关闭搜索UI时将调用的回调。

参数
听众 这个搜索管理器。OnDismissListener使用,或为空。

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

已在中添加API级别1

启动搜索UI。

搜索管理器将以重叠方式打开搜索小部件窗口中,基础活动可能会被遮挡。搜索进入状态将一直有效,直到发生以下事件之一:

  • 用户完成搜索。在大多数情况下,这将启动搜索意图。
  • 用户使用back、home或其他键退出搜索。
  • 应用程序调用停止搜索()方法,它将隐藏搜索窗口并将焦点返回给发起活动。
  • 大多数应用程序将使用此接口调用搜索。调用搜索的主要方法是调用Activity.onSearchRequested()Activity.startSearch()

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

公众空隙 停止搜索 ()

已在中添加API级别1

终止搜索UI。

通常,用户将通过启动搜索或取消。此函数允许底层应用程序或活动提前取消搜索(出于任何原因)。

可以随时安全地调用此函数(即使没有搜索处于活动状态)

公众空隙 触发器搜索 (字符串查询,组件名称启动活动,捆绑应用搜索数据)

已在中添加API级别5

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

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