Activity.StartSearch(String, Boolean, Bundle, Boolean) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se llama a este enlace para iniciar la interfaz de usuario de búsqueda.
[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
Parámetros
- initialQuery
- String
Cualquier cadena no vacía que no sea NULL se insertará como texto escrito previamente en el cuadro de consulta de búsqueda.
- selectInitialQuery
- Boolean
Si es true, se preseleccionará la consulta inicial, lo que significa que cualquier escritura adicional lo reemplazará. Esto es útil para los casos en los que se inserta una consulta previamente completa. Si es false, el punto de selección se colocará al final de la consulta insertada. Esto resulta útil cuando la consulta insertada es texto que escribió el usuario y el usuario esperaría poder seguir escribiendo. Este parámetro solo es significativo si initialQuery es una cadena no vacía.
- appSearchData
- Bundle
Una aplicación puede insertar aquí contexto específico de la aplicación para mejorar la calidad o la especificidad de sus propias búsquedas. Estos datos se devolverán con intenciones SEARCH. Null si no se requiere ningún dato adicional.
- globalSearch
- Boolean
Si es false, esto solo iniciará la búsqueda definida específicamente por la aplicación (que normalmente se define como una búsqueda local). Si no se define ninguna búsqueda predeterminada en la aplicación o actividad actual, se iniciará búsqueda global. Si es true, siempre se iniciará una búsqueda global de plataforma (por ejemplo, basada en web).
- Atributos
Comentarios
Se llama a este enlace para iniciar la interfaz de usuario de búsqueda.
Normalmente se llama desde onSearchRequested(), ya sea directamente desde Activity.onSearchRequested() o desde una versión invalidada en cualquier actividad determinada. Si su objetivo es simplemente activar la búsqueda, es preferible llamar a onSearchRequested(), que puede que se haya invalidado en otro lugar de la actividad. Si su objetivo es insertar datos específicos, como datos de contexto, se prefiere invalidar onSearchRequested(), de modo que los autores de llamadas se beneficien de la invalidación.
Nota: cuando se ejecuta en , Configuration#UI_MODE_TYPE_WATCH
no se admite el uso de esta API.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código y se usan según los términos descritos en la creative Commons 2.5.