SearchManager.StartSearch Método

Definição

Namespace:: Android.App

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Iniciar a interface do usuário da pesquisa.

[Android.Runtime.Register("startSearch", "(Ljava/lang/String;ZLandroid/content/ComponentName;Landroid/os/Bundle;Z)V", "GetStartSearch_Ljava_lang_String_ZLandroid_content_ComponentName_Landroid_os_Bundle_ZHandler")]
public virtual void StartSearch(string? initialQuery, bool selectInitialQuery, Android.Content.ComponentName? launchActivity, Android.OS.Bundle? appSearchData, bool globalSearch);

[<Android.Runtime.Register("startSearch", "(Ljava/lang/String;ZLandroid/content/ComponentName;Landroid/os/Bundle;Z)V", "GetStartSearch_Ljava_lang_String_ZLandroid_content_ComponentName_Landroid_os_Bundle_ZHandler")>]
abstract member StartSearch : string * bool * Android.Content.ComponentName * Android.OS.Bundle * bool -> unit
override this.StartSearch : string * bool * Android.Content.ComponentName * Android.OS.Bundle * bool -> unit

Parâmetros

initialQuery: String

Uma cadeia de caracteres de pesquisa pode ser pré-inserida aqui, mas normalmente é nula ou vazia.

selectInitialQuery: Boolean

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.

launchActivity: ComponentName

O ComponentName da atividade que iniciou essa pesquisa.

appSearchData: Bundle

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.

globalSearch: Boolean

Se for false, isso iniciará apenas a pesquisa que foi definida especificamente pelo aplicativo (que geralmente é definida 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

Iniciar a interface do usuário da pesquisa. O gerenciador de pesquisa abrirá um widget de pesquisa em uma janela sobreposta e a atividade subjacente poderá ser obscurecida. O estado de entrada de pesquisa permanecerá em vigor até que um dos seguintes eventos: o usuário conclua a pesquisa. Na maioria dos casos, isso iniciará uma intenção de pesquisa. O usuário usa as chaves voltar, voltar para casa ou outras chaves para sair da pesquisa. O aplicativo chama o método stopSearch(), que ocultará a janela de pesquisa e retornará o foco para a atividade da qual foi iniciado. A maioria dos aplicativos não usará essa interface para invocar a pesquisa. O método principal para invocar a pesquisa é chamar Activity.onSearchRequested() ou Activity.startSearch().

Consulte também:

Referência do Android para android.app.SearchManager.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.

Aplica-se a