SearchSuggestionManager.SuggestionsRequested 事件
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
當使用者的查詢文字變更，且應用程式需要提供新的建議，才能顯示在搜尋方塊中時引發。
// Register
event_token SuggestionsRequested(TypedEventHandler<SearchSuggestionManager, SearchSuggestionsRequestedEventArgs const&> const& handler) const;
// Revoke with event_token
void SuggestionsRequested(event_token const* cookie) const;
// Revoke with event_revoker
SearchSuggestionManager::SuggestionsRequested_revoker SuggestionsRequested(auto_revoke_t, TypedEventHandler<SearchSuggestionManager, SearchSuggestionsRequestedEventArgs const&> const& handler) const;public event TypedEventHandler<SearchSuggestionManager,SearchSuggestionsRequestedEventArgs> SuggestionsRequested;function onSuggestionsRequested(eventArgs) { /* Your code */ }
searchSuggestionManager.addEventListener("suggestionsrequested", onSuggestionsRequested);
searchSuggestionManager.removeEventListener("suggestionsrequested", onSuggestionsRequested);
- or -
searchSuggestionManager.onsuggestionsrequested = onSuggestionsRequested;Public Custom Event SuggestionsRequested As TypedEventHandler(Of SearchSuggestionManager, SearchSuggestionsRequestedEventArgs) 事件類型
備註
建議可能來自三個來源：搜尋歷程記錄、本機檔案，或來自應用程式所指定的來源。 建議會依來源分組，並在搜尋窗格中依下列順序顯示：搜尋歷程記錄、本機檔案，以及應用程式指定的來源。
如果您的應用程式參與搜尋合約，而且您希望您的應用程式顯示您指定來源的建議，則必須註冊處理常式，以在引發此事件時回應。 在您的 SuggestionsRequested 事件處理常式中，根據使用者的QueryText取得建議並填入SearchSuggestionCollection來回應。
注意
如果您想要以非同步方式回應此事件，您必須從 Request 屬性取得延遲。
無法提供空白搜尋方塊的建議，因此當使用者更新搜尋方塊為空白時，不會引發此事件。
搜尋建議的類型
您的應用程式可以顯示兩種類型的建議：可協助使用者精簡查詢 (查詢建議) ，以及查詢實際結果的建議 (結果建議) 。 您可以選擇顯示或這兩種類型的建議。
如果您提供查詢建議，且使用者選取其中一個查詢，則您的應用程式應該會在應用程式的搜尋結果頁面中顯示所選取、精簡查詢的結果來回應。
如果您提供結果建議，您也必須註冊 ResultSuggestionChosen 事件處理常式，以便在使用者選取其中一個結果建議時回應，而且您可以向使用者顯示結果。
取得建議
以下是您的應用程式可用來取得建議的幾個來源範例：
- 從應用程式定義的靜態本機清單
- 從支援OpenSearch 格式建議的 URL
在搜尋方塊控制項中顯示應用程式提供的建議
取得建議之後，您可以將建議新增至要求的SearchSuggestionCollection，以在搜尋窗格中顯示建議。
如果您選擇同時顯示查詢建議和結果建議，您應該依建議類型將建議分組 (查詢或結果) ，並使用 AppendSearchSeparator分隔群組。 每個分隔符號都會取代建議，而且必須接著至少一個建議，減少您可以顯示的建議數目。