Поделиться через

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. Дополнительные сведения см. в разделе Поле автозаполнения .

Не следует использовать API-интерфейсы Windows.ApplicationModel.Search (SearchPane, SearchContract) или SearchBox в приложениях для Windows 10 или более поздней версии.

Предложения результатов следует использовать вместо предложений запросов только для отображения результатов с высоким уровнем достоверности, которые приводят пользователя непосредственно к элементу, а не к представлению, в котором отображаются результаты поиска.

Предлагаемые результаты включают изображение и необязательный подробный текст для отображения с предложением в области поиска. Изображение сообщает пользователю, что он видит результаты, а не предложения запросов. Если изображения для результата не существует, можно использовать универсальное изображение или значок, представляющий результат или тип результата.

Чтобы предоставить предложения результатов, необходимо прослушать и обработать событие ResultSuggestionChosen .

В области поиска может отображаться не более 5 предложений. Кроме того, каждый используемый разделитель занимает место предложения и уменьшает количество отображаемых предложений.

Применяется к

См. также раздел