共用方式為

SearchSuggestionCollection.AppendResultSuggestion 方法

  • 參考

定義

命名空間:
Windows.ApplicationModel.Search
編輯

將建議的搜尋結果附加至要顯示在搜尋窗格中的建議清單。

public:
 virtual void AppendResultSuggestion(Platform::String ^ text, Platform::String ^ detailText, Platform::String ^ tag, IRandomAccessStreamReference ^ image, Platform::String ^ imageAlternateText) = AppendResultSuggestion;
void AppendResultSuggestion(winrt::hstring const& text, winrt::hstring const& detailText, winrt::hstring const& tag, IRandomAccessStreamReference const& image, winrt::hstring const& imageAlternateText);
public void AppendResultSuggestion(string text, string detailText, string tag, IRandomAccessStreamReference image, string imageAlternateText);
function appendResultSuggestion(text, detailText, tag, image, imageAlternateText)
Public Sub AppendResultSuggestion (text As String, detailText As String, tag As String, image As IRandomAccessStreamReference, imageAlternateText As String)

參數

text
String

Platform::String

winrt::hstring

建議結果的文字。

detailText
String

Platform::String

winrt::hstring

建議結果的詳細資料文字。

tag
String

Platform::String

winrt::hstring

識別此建議結果的唯一標記。

如果使用者選取此建議的結果， 就會發生 ResultSuggestionChosen 事件。 當應用程式處理此事件時，它可以從 SearchPaneResultSuggestionChosenEventArgs.Tag 屬性取得所選結果建議的標記。

image
IRandomAccessStreamReference

要隨附結果建議的影像。 影像應該是 40 x 40。 Windows 會縮放或裁剪較小或較大的影像。

imageAlternateText
String

Platform::String

winrt::hstring

影像的替代文字。

備註

重要

若要在應用程式中實作Windows 10或更新版本的搜尋，請使用AutoSuggestBox。 如需詳細資訊 ，請參閱自動建議方塊 。

您不應該在 app 中使用Windows.ApplicationModel.Search API (SearchPane、 SearchContract) 或SearchBox API，以供Windows 10或更新版本使用。

您應該使用結果建議而非查詢建議，只顯示將使用者直接帶至專案的高信賴度結果，而不是顯示搜尋結果的檢視。

建議的結果包含影像和選擇性詳細資料文字，以在搜尋窗格中顯示建議。 影像會向使用者發出訊號，指出他們看到結果，而不是查詢建議。 如果結果的影像不存在，您可以使用代表結果或結果類型的泛型影像或圖示。

如果您想要提供結果建議，您必須接聽並處理 ResultSuggestionChosen 事件。

搜尋窗格最多可以顯示 5 個建議。 此外，您使用的每個分隔符號都會取代建議，並降低您可以顯示的建議數目。

適用於

另請參閱