語言

SearchManager.StartSearch 方法

定義

命名空間:
Android.App
組件:
Mono.Android.dll

啟動搜尋介面。

[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

參數

initialQuery
String

此處可預先輸入搜尋字串，但通常是空或空的。

selectInitialQuery
Boolean

若為真，初始查詢將被預先選擇，意即任何後續輸入都會取代該查詢。 這對於插入整個預置查詢的情況非常有用。 若為假，選取點會置於插入查詢的末尾。 當插入的查詢是使用者輸入的文字，且使用者預期能持續輸入時，這很有用。 此參數僅在 initialQuery 為非空字串時有意義。

launchActivity
ComponentName

啟動此搜尋的活動的組件名稱。

appSearchData
Bundle

應用程式可以在此插入特定應用的上下文，以提升自身搜尋的品質或具體性。 這些資料將以搜尋意圖回傳。 若不需要額外資料，則為空。

globalSearch
Boolean

若為錯誤，則只會啟動應用程式明確定義的搜尋（通常定義為局部搜尋）。 若目前應用程式或活動中未定義預設搜尋，則會啟動全域搜尋。 如果屬實，這總是會啟動平台全球（例如網頁）搜尋。

屬性
RegisterAttribute

備註

啟動搜尋介面。 搜尋管理器會在重疊視窗中開啟搜尋小工具，底層活動可能會被遮蔽。 搜尋輸入狀態將持續有效，直到以下事件之一發生：使用者完成搜尋。 大多數情況下，這會啟動搜尋意圖。 使用者使用返回鍵、首頁鍵或其他鍵來退出搜尋。 應用程式呼叫 stopSearch（） 方法，會隱藏搜尋視窗並將焦點回到啟動時的活動。 大多數應用程式不會使用此介面來啟動搜尋。 呼叫搜尋的主要方法是呼叫 Activity.onSearchRequested（） 或 Activity.startSearch（）。

另請參閱：

Android 參考資料。android.app.SearchManager.startSearch

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於