Langue

Activity.StartSearch(String, Boolean, Bundle, Boolean) Méthode

Définition

Ce hook est appelé pour lancer l’interface utilisateur de recherche.

[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

Paramètres

initialQuery
String

Toute chaîne non vide non null est insérée comme texte prédéfini dans la zone de requête de recherche.

selectInitialQuery
Boolean

Si la valeur est true, la requête initiale est préélectionnée, ce qui signifie que toute autre saisie la remplacera. Cela est utile pour les cas où une requête pré-formée entière est insérée. Si la valeur est false, le point de sélection est placé à la fin de la requête insérée. Cela est utile lorsque la requête insérée est du texte entré par l’utilisateur et que l’utilisateur s’attend à pouvoir continuer à taper. Ce paramètre n’est significatif que si initialQuery est une chaîne non vide.

appSearchData
Bundle

Une application peut insérer un contexte spécifique à l’application ici, afin d’améliorer la qualité ou la spécificité de ses propres recherches. Ces données seront retournées avec les intentions SEARCH. Null si aucune donnée supplémentaire n’est requise.

globalSearch
Boolean

Si la valeur est false, elle lance uniquement la recherche qui a été spécifiquement définie par l’application (qui est généralement définie comme une recherche locale). Si aucune recherche par défaut n’est définie dans l’application ou l’activité actuelle, la recherche globale est lancée. Si la valeur est true, cela lance toujours une recherche globale sur la plateforme (par exemple, basée sur le web) à la place.

Attributs

Remarques

Ce hook est appelé pour lancer l’interface utilisateur de recherche. Il est généralement appelé à partir de onSearchRequested(), directement à partir d’Activity.onSearchRequested() ou d’une version substituée dans une activité donnée. Si votre objectif est simplement d’activer la recherche, il est préférable d’appeler onSearchRequested(), qui a peut-être été remplacé ailleurs dans votre activité. Si votre objectif est d’injecter des données spécifiques telles que des données de contexte, il est préférable de remplacer onSearchRequested(), afin que tous les appelants puissent bénéficier de la substitution. Remarque : lors de l’exécution dans un Configuration.UI_MODE_TYPE_WATCH, l’utilisation de cette API n’est pas prise en charge.

Voir aussi :

Référence Android pour android.app.Activity.startSearch.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à