# SearchBar.SearchBarListener

Artifact: [androidx.leanback:leanback](https://developer.android.com/jetpack/androidx/releases/leanback) [View Source](https://cs.android.com/search?q=file:androidx/leanback/widget/SearchBar.java+class:androidx.leanback.widget.SearchBar.SearchBarListener) Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

*** ** * ** ***


```
public interface SearchBar.SearchBarListener
```

<br />

*** ** * ** ***

Interface for receiving notification of search query changes.

## Summary

| ### Public methods |
|---|---|
| `abstract void` | `https://developer.android.com/reference/androidx/leanback/widget/SearchBar.SearchBarListener#onKeyboardDismiss(java.lang.String)(https://developer.android.com/reference/java/lang/String.html query)` Method invoked when the IME is being dismissed. |
| `abstract void` | `https://developer.android.com/reference/androidx/leanback/widget/SearchBar.SearchBarListener#onSearchQueryChange(java.lang.String)(https://developer.android.com/reference/java/lang/String.html query)` Method invoked when the search bar detects a change in the query. |
| `abstract void` | `https://developer.android.com/reference/androidx/leanback/widget/SearchBar.SearchBarListener#onSearchQuerySubmit(java.lang.String)(https://developer.android.com/reference/java/lang/String.html query)` Method invoked when the search query is submitted. |

## Public methods

### onKeyboardDismiss

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
abstract void onKeyboardDismiss(String query)
```

Method invoked when the IME is being dismissed.

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/lang/String.html query` | The query set in the search bar at the time the IME is being dismissed. |

### onSearchQueryChange

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
abstract void onSearchQueryChange(String query)
```

Method invoked when the search bar detects a change in the query.

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/lang/String.html query` | The current full query. |

### onSearchQuerySubmit

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
abstract void onSearchQuerySubmit(String query)
```

Method invoked when the search query is submitted.

This method can be called without a preceeding onSearchQueryChange, in particular in the case of a voice input.

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/lang/String.html query` | The query being submitted. |