SearchManager.StartSearch 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
啟動搜尋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
參數
- initialQuery
- String
您可以在這裡預先輸入搜尋字串,但這通常是 Null 或空白。
- selectInitialQuery
- Boolean
如果為 true,則會預先選取初始查詢,這表示任何進一步輸入都會取代它。 這適用於插入整個預先形成查詢的情況。 如果為 false,選取點將會放在插入查詢的結尾。 當插入的查詢是使用者輸入的文字,而且使用者預期能夠繼續輸入時,這會很有用。 只有在 initialQuery 是非空字串時,此參數才有意義。
- launchActivity
- ComponentName
已啟動此搜尋之活動的 ComponentName。
- appSearchData
- Bundle
應用程式可以在這裡插入應用程式特定內容,以改善本身搜尋的品質或特定性。 此數據會以 SEARCH 意圖傳回。 如果不需要額外的數據,則為 Null。
- globalSearch
- Boolean
如果為 false,則只會啟動應用程式特別定義的搜尋(通常定義為本機搜尋)。 如果目前應用程式或活動中未定義預設搜尋,將會啟動全域搜尋。 如果為 true,則一律會啟動平臺全域 (例如 Web 型) 搜尋。
- 屬性
備註
啟動搜尋UI。
搜尋管理員會在重疊的視窗中開啟搜尋小工具,而且基礎活動可能會模糊不清。 搜尋項目狀態會維持有效狀態,直到下列其中一個事件為止: <ul><li>使用者完成搜尋。 在大部分情況下,這會啟動搜尋意圖。</li li><>使用者使用返回、住家或其他密鑰結束搜尋。</li li>><應用程式會呼叫 #stopSearch
方法,這會隱藏搜尋視窗,並將焦點傳回啟動活動。</李>
大部分的應用程式都不會使用此介面來叫用搜尋。 叫用搜尋的主要方法是呼叫 android.app.Activity#onSearchRequested Activity.onSearchRequested()
或 android.app.Activity#startSearch Activity.startSearch()
。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。