Activity.StartSearch(String, Boolean, Bundle, Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Этот обработчик вызывается для запуска пользовательского интерфейса поиска.
[Android.Runtime.Register("startSearch", "(Ljava/lang/String;ZLandroid/os/Bundle;Z)V", "GetStartSearch_Ljava_lang_String_ZLandroid_os_Bundle_ZHandler")]
public virtual void StartSearch (string? initialQuery, bool selectInitialQuery, Android.OS.Bundle? appSearchData, bool globalSearch);
[<Android.Runtime.Register("startSearch", "(Ljava/lang/String;ZLandroid/os/Bundle;Z)V", "GetStartSearch_Ljava_lang_String_ZLandroid_os_Bundle_ZHandler")>]
abstract member StartSearch : string * bool * Android.OS.Bundle * bool -> unit
override this.StartSearch : string * bool * Android.OS.Bundle * bool -> unit
Параметры
- initialQuery
- String
Любая непустая строка, не пустая, будет вставлена как предварительно введенный текст в поле поискового запроса.
- selectInitialQuery
- Boolean
Если задано значение true, начальный запрос будет предварительно выбран, что означает, что его заменит любой дальнейший ввод. Это полезно в случаях, когда вставляется весь предварительно сформированный запрос. Если значение равно false, точка выбора будет размещена в конце вставленного запроса. Это полезно, если вставленный запрос представляет собой текст, введенный пользователем, и пользователь ожидает, что сможет продолжать вводить текст. Этот параметр имеет смысл, только если initialQuery является непустой строкой.
- appSearchData
- Bundle
Приложение может вставить сюда контекст конкретного приложения, чтобы улучшить качество или специфичность собственного поиска. Эти данные будут возвращены с намерением ПОИСКА. Значение NULL, если дополнительные данные не требуются.
- globalSearch
- Boolean
Если значение равно false, будет запущен только поиск, который был специально определен приложением (который обычно определяется как локальный поиск). Если поиск по умолчанию в текущем приложении или действии не определен, будет запущен глобальный поиск. Если задано значение true, это всегда будет запускать глобальный по платформе (например, веб-) поиск.
- Атрибуты
Комментарии
Этот обработчик вызывается для запуска пользовательского интерфейса поиска.
Обычно он вызывается из onSearchRequested() непосредственно из Activity.onSearchRequested() или из переопределенной версии в любом заданном действии. Если ваша цель — просто активировать поиск, рекомендуется вызвать метод onSearchRequested(), который, возможно, был переопределен в другом месте действия. Если ваша цель заключается в внедрении определенных данных, таких как данные контекста, рекомендуется переопределить onSearchRequested(), чтобы все вызывающие к нему абоненты могли воспользоваться преимуществами переопределения.
Примечание. При выполнении в Configuration#UI_MODE_TYPE_WATCH
, использование этого API не поддерживается.
Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом Android и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License.