語言

Activity.StartSearch(String, Boolean, Bundle, Boolean) 方法

定義

這個 hook 是用來啟動搜尋介面的。

[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

參數

initialQuery
String

任何非空、非空的字串都會以預先輸入的文字插入搜尋查詢框。

selectInitialQuery
Boolean

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

appSearchData
Bundle

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

globalSearch
Boolean

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

屬性

備註

這個 hook 是用來啟動搜尋介面的。 通常由 onSearchRequested() 呼叫,直接從 Activity.onSearchRequested() 呼叫,或從任一活動中覆寫的版本呼叫。 如果你的目標只是啟動搜尋,建議呼叫 onSearchRequested(),但這個功能可能已經在你的活動其他地方被覆蓋了。 如果你的目標是注入特定資料,例如上下文資料,則建議覆蓋 onSearchRequested(),這樣呼叫者都能從覆蓋中受益。 注意:在Configuration.UI_MODE_TYPE_WATCH中運行時,不支援使用此 API。

另請參閱:

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

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

適用於