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

Definição

Namespace:

Android.App

Assembly:

Mono.Android.dll

Esse gancho é chamado para iniciar a interface do usuário de pesquisa.

[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

Cadeia de caracteres: qualquer cadeia de caracteres não vazia não nula será inserida como texto pré-inserido na caixa de consulta de pesquisa.

selectInitialQuery

Boolean

booliano: se for true, a consulta inicial será pré-selecionada, o que significa que qualquer digitação adicional a substituirá. Isso é útil para casos em que uma consulta pré-formada inteira está sendo inserida. Se for falso, o ponto de seleção será colocado no final da consulta inserida. Isso é útil quando a consulta inserida é o texto que o usuário inseriu e o usuário espera poder continuar digitando. Esse parâmetro só será significativo se initialQuery for uma cadeia de caracteres não vazia.

appSearchData

Bundle

Pacote: um aplicativo pode inserir o contexto específico do aplicativo aqui, a fim de melhorar a qualidade ou a especificidade de suas próprias pesquisas. Esses dados serão retornados com intenções SEARCH. Nulo se nenhum dado extra for necessário. Esse valor pode ser nulo.

globalSearch

Boolean

booleano: se for falso, isso só iniciará a pesquisa que foi definida especificamente pelo aplicativo (que geralmente é definido como uma pesquisa local). Se nenhuma pesquisa padrão for definida no aplicativo ou atividade atual, a pesquisa global será iniciada. Se for verdade, isso sempre iniciará uma pesquisa de plataforma global (por exemplo, baseada na Web).

Atributos

RegisterAttribute

Comentários

Esse gancho é chamado para iniciar a interface do usuário de pesquisa. Normalmente, ele é chamado de onSearchRequested(), diretamente de Activity.onSearchRequested() ou de uma versão substituída em qualquer atividade específica. Se sua meta for simplesmente ativar a pesquisa, é preferível chamar onSearchRequested(), que pode ter sido substituído em outro lugar em sua Atividade. Se sua meta for injetar dados específicos, como dados de contexto, é preferível substituir onSearchRequested(), para que todos os chamadores se beneficiem da substituição. Observação: ao executar em um Configuration.UI_MODE_TYPE_WATCH, não há suporte para o uso dessa API.

Consulte também:

Referência do Android para android.app.Activity.startSearch.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.