Freigeben über


SearchManager.StartSearch Methode

Definition

Starten Sie die Such-UI.

[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

Parameter

initialQuery
String

Eine Suchzeichenfolge kann hier bereits eingegeben werden, dies ist jedoch in der Regel null oder leer.

selectInitialQuery
Boolean

Bei "true" wird die ursprüngliche Abfrage vorab ausgewählt, was bedeutet, dass alle weiteren Eingaben sie ersetzen. Dies ist nützlich für Fälle, in denen eine gesamte vordefinierte Abfrage eingefügt wird. Wenn false, wird der Auswahlpunkt am Ende der eingefügten Abfrage platziert. Dies ist nützlich, wenn die eingefügte Abfrage Text ist, den der Benutzer eingegeben hat, und der Benutzer erwartet, dass er die Eingabe beibehalten kann. Dieser Parameter ist nur dann sinnvoll, wenn initialQuery eine nicht leere Zeichenfolge ist.

launchActivity
ComponentName

Der ComponentName der Aktivität, die diese Suche gestartet hat.

appSearchData
Bundle

Eine Anwendung kann hier anwendungsspezifischen Kontext einfügen, um die Qualität oder Spezifität ihrer eigenen Suchvorgänge zu verbessern. Diese Daten werden mit SEARCH-Absichten zurückgegeben. Null, wenn keine zusätzlichen Daten erforderlich sind.

globalSearch
Boolean

Wenn false, startet dies nur die Suche, die speziell von der Anwendung definiert wurde (die in der Regel als lokale Suche definiert wurde). Wenn keine Standardsuche in der aktuellen Anwendung oder Aktivität definiert ist, wird die globale Suche gestartet. Ist dies der Fall, wird stattdessen immer eine plattform-globale Suche (z. B. webbasierte) Suche gestartet.

Attribute

Hinweise

Starten Sie die Such-UI.

Der Such-Manager öffnet ein Such-Widget in einem überlappenden Fenster, und die zugrunde liegende Aktivität wird möglicherweise verdeckt. Der Sucheintragsstatus bleibt bis zu einem der folgenden Ereignisse wirksam: <ul><li>Der Benutzer schließt die Suche ab. In den meisten Fällen wird dadurch eine Suchabsicht gestartet.</li Li><>Der Benutzer verwendet die Zurück-, Start- oder andere Schlüssel, um die Suche zu beenden.</li><>Li Die Anwendung ruft die #stopSearch Methode auf, die das Suchfenster ausblendet und den Fokus auf die Aktivität zurückgibt, von der sie gestartet wurde.</Li>

Die meisten Anwendungen verwenden diese Schnittstelle nicht , um die Suche aufzurufen. Die primäre Methode zum Aufrufen der Suche ist das Aufrufen oder android.app.Activity#startSearch Activity.startSearch()Aufrufen android.app.Activity#onSearchRequested Activity.onSearchRequested() von .

Java-Dokumentation für android.app.SearchManager.startSearch(java.lang.String, boolean, android.content.ComponentName, android.os.Bundle, boolean).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

Weitere Informationen