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

定義

呼叫此勾點以啟動搜尋 UI。

[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

任何非 Null 非空白字串都會插入為搜尋查詢方塊中預先輸入的文字。

selectInitialQuery
Boolean

如果為 true,則會預先選取初始查詢,這表示任何進一步的輸入都會取代它。 這適用于插入整個預先形成查詢的情況。 如果為 false,則會將選取點放在插入查詢的結尾。 當插入的查詢是使用者輸入的文字,而且使用者預期能夠繼續輸入時,這會很有用。 只有當 initialQuery 是非空字串時,此參數才有意義。

appSearchData
Bundle

應用程式可以在這裡插入應用程式特定內容,以改善其本身搜尋的品質或特定性。 此資料會以 SEARCH 意圖傳回, (s) 。 如果不需要額外的資料,則為 Null。

globalSearch
Boolean

如果為 false,則只會啟動應用程式特別定義的搜尋 (,通常定義為本機搜尋) 。 如果未在目前的應用程式或活動中定義預設搜尋,將會啟動全域搜尋。 如果為 true,則一律會啟動平臺全域 (,例如網頁型) 搜尋。

屬性

備註

呼叫此勾點以啟動搜尋 UI。

它通常是從 onSearchRequested () 呼叫,無論是直接從 Activity.onSearchRequested () 或從任何指定活動中覆寫的版本呼叫。 如果您的目標是只啟用搜尋,建議您呼叫 onSearchRequested () ,這可能已在活動的其他位置被覆寫。 如果您的目標是插入特定資料,例如內容資料,建議您 覆寫 onSearchRequested () ,讓其的任何呼叫端都受益于覆寫。

注意:在 中 Configuration#UI_MODE_TYPE_WATCH 執行 時,不支援使用此 API。

android.app.Activity.startSearch(java.lang.String, boolean, android.os.Bundle, boolean) JAVA 檔。

此頁面的部分是根據 原始碼專案所建立和共用的工作進行修改,並根據中所述的詞彙使用。

適用於

另請參閱