Activity.StartSearch(String, Boolean, Bundle, Boolean) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.