Most visited

Recently visited

SearchBar

public class SearchBar
extends RelativeLayout

java.lang.Object
   ↳ android.view.View
     ↳ android.view.ViewGroup
       ↳ android.widget.RelativeLayout
         ↳ android.support.v17.leanback.widget.SearchBar


包含搜索范围和文本输入视图的搜索小部件。

注意:如果SpeechRecognitionCallback未使用,即使用SpeechRecognizer ,则应用程序需要在清单文件中声明android.permission.RECORD_AUDIO。 如果您的应用程序目标> = 23且设备运行> = 23,则需要实现SearchBar.SearchBarPermissionListener ,其中请求运行时权限。

Summary

Nested classes

interface SearchBar.SearchBarListener

用于接收搜索查询更改通知的界面。

interface SearchBar.SearchBarPermissionListener

处理运行时权限请求的接口。

Inherited XML attributes

From class android.widget.RelativeLayout
From class android.view.ViewGroup
From class android.view.View

Inherited constants

From class android.widget.RelativeLayout
From class android.view.ViewGroup
From class android.view.View

Inherited fields

From class android.view.View

Public constructors

SearchBar(Context context)
SearchBar(Context context, AttributeSet attrs)
SearchBar(Context context, AttributeSet attrs, int defStyle)

Public methods

void displayCompletions(CompletionInfo[] completions)

更新IME显示的完成列表

void displayCompletions(List<String> completions)

更新IME显示的完成列表

Drawable getBadgeDrawable()

返回可绘制的徽章

CharSequence getHint()

返回当前搜索栏提示文本。

String getTitle()

返回当前标题

boolean isRecognizing()

如果没有运行Recognizer,则返回true,否则返回false。

void setBadgeDrawable(Drawable drawable)

设置显示在搜索栏内的可绘制徽章。

void setNextFocusDownId(int viewId)

设置下一个焦点为 FOCUS_DOWN时要使用的视图的ID。

void setPermissionListener(SearchBar.SearchBarPermissionListener listener)

设置处理运行时权限请求的侦听器。

void setSearchBarListener(SearchBar.SearchBarListener listener)

为术语搜索更改时设置侦听器

void setSearchQuery(String query)

设置搜索查询

void setSpeechRecognitionCallback(SpeechRecognitionCallback request)

设置语音识别回调。

void setSpeechRecognizer(SpeechRecognizer recognizer)

设置要在进行语音搜索时使用的语音识别器。

void setTitle(String title)

设置搜索栏中显示的提示中使用的标题文本。

void startRecognition()
void stopRecognition()

如果已经开始,停止语音识别。

Protected methods

void onAttachedToWindow()

这在视图附加到窗口时被调用。

void onDetachedFromWindow()

这是在视图从窗口分离时调用的。

void onFinishInflate()

最终确定从XML扩展视图。

Inherited methods

From class android.widget.RelativeLayout
From class android.view.ViewGroup
From class android.view.View
From class java.lang.Object
From interface android.view.ViewParent
From interface android.view.ViewManager
From interface android.graphics.drawable.Drawable.Callback
From interface android.view.KeyEvent.Callback
From interface android.view.accessibility.AccessibilityEventSource

Public constructors

SearchBar

SearchBar (Context context)

Parameters
context Context

SearchBar

SearchBar (Context context, 
                AttributeSet attrs)

Parameters
context Context
attrs AttributeSet

SearchBar

SearchBar (Context context, 
                AttributeSet attrs, 
                int defStyle)

Parameters
context Context
attrs AttributeSet
defStyle int

Public methods

displayCompletions

void displayCompletions (CompletionInfo[] completions)

更新IME显示的完成列表

Parameters
completions CompletionInfo: list of completions shown in the IME, can be null or empty to clear them

displayCompletions

void displayCompletions (List<String> completions)

更新IME显示的完成列表

Parameters
completions List: list of completions shown in the IME, can be null or empty to clear them

getBadgeDrawable

Drawable getBadgeDrawable ()

返回可绘制的徽章

Returns
Drawable

getHint

CharSequence getHint ()

返回当前搜索栏提示文本。

Returns
CharSequence

getTitle

String getTitle ()

返回当前标题

Returns
String

isRecognizing

boolean isRecognizing ()

如果没有运行Recognizer,则返回true,否则返回false。

Returns
boolean True if is not running Recognizer, false otherwise.

setBadgeDrawable

void setBadgeDrawable (Drawable drawable)

设置显示在搜索栏内的可绘制徽章。

Parameters
drawable Drawable: The drawable to be used in the search bar.

setNextFocusDownId

void setNextFocusDownId (int viewId)

设置下一个焦点为 FOCUS_DOWN时要使用的视图的ID。

Parameters
viewId int: The next focus ID, or NO_ID if the framework should decide automatically.

setPermissionListener

void setPermissionListener (SearchBar.SearchBarPermissionListener listener)

设置处理运行时权限请求的侦听器。

Parameters
listener SearchBar.SearchBarPermissionListener: Listener that handles runtime permission requests.

setSearchBarListener

void setSearchBarListener (SearchBar.SearchBarListener listener)

为术语搜索更改时设置侦听器

setSearchQuery

void setSearchQuery (String query)

设置搜索查询

Parameters
query String: the search query to use

setSpeechRecognitionCallback

void setSpeechRecognitionCallback (SpeechRecognitionCallback request)

设置语音识别回调。

Parameters
request SpeechRecognitionCallback

setSpeechRecognizer

void setSpeechRecognizer (SpeechRecognizer recognizer)

设置要在进行语音搜索时使用的语音识别器。 活动/片段负责创建和销毁具有自己生命周期的识别器。

Parameters
recognizer SpeechRecognizer: a SpeechRecognizer

setTitle

void setTitle (String title)

设置搜索栏中显示的提示中使用的标题文本。

Parameters
title String: The hint to use.

startRecognition

void startRecognition ()

stopRecognition

void stopRecognition ()

如果已经开始,停止语音识别。

Protected methods

onAttachedToWindow

void onAttachedToWindow ()

这在视图附加到窗口时被调用。 此时它有一个Surface并将开始绘制。 注意这个函数保证在onDraw(android.graphics.Canvas)之前被调用,但是它可以在第一个onDraw之前的任何时候调用 - 包括在onMeasure(int, int)之前或之后。

onDetachedFromWindow

void onDetachedFromWindow ()

这是在视图从窗口分离时调用的。 此时它不再有绘图表面。

onFinishInflate

void onFinishInflate ()

最终确定从XML扩展视图。 这被称为通货膨胀的最后一个阶段,毕竟所有的孩子的观点已被添加。

即使子类重写onFinishInflate,他们也应该始终确保调用super方法,以便调用。

Hooray!