Activity.StartSearch(String, Boolean, Bundle, Boolean) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
這個 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 所創建與分享的作品,並依授權條款所描述的使用進行修改。