SearchSuggestionCollection.AppendResultSuggestion 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
제안된 검색 결과를 검색 창에 표시할 제안 목록에 추가합니다.
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 속성에서 선택한 결과 제안의 태그를 가져올 수 있습니다.
결과 제안과 함께 사용할 이미지입니다. 이미지는 40 x 40이어야 합니다. Windows는 더 작거나 더 큰 이미지의 크기를 조정하거나 자랄 것입니다.
- imageAlternateText
-
String
Platform::String
winrt::hstring
이미지의 대체 텍스트입니다.
설명
중요
앱에서 Windows 10 이상 검색을 구현하려면 AutoSuggestBox를 사용합니다. 자세한 내용은 자동 제안 상자를 참조하세요.
Windows 10 이상 앱에서 Windows.ApplicationModel.Search API(SearchPane, SearchContract) 또는 SearchBox API를 사용하면 안 됩니다.
쿼리 제안 대신 결과 제안을 사용하여 검색 결과를 보여 주는 보기 대신 항목으로 직접 사용자를 데려가는 신뢰도가 높은 결과를 표시해야 합니다.
제안된 결과에는 검색 창에 제안 사항과 함께 표시할 이미지 및 선택적 세부 정보 텍스트가 포함됩니다. 이미지는 쿼리 제안이 아니라 결과를 보고 있음을 사용자에게 알릴 수 있습니다. 결과에 대한 이미지가 없는 경우 결과 또는 결과 형식을 나타내는 제네릭 이미지 또는 아이콘을 사용할 수 있습니다.
결과 제안을 제공하려면 ResultSuggestionChosen 이벤트를 수신 대기하고 처리해야 합니다.
검색 창에는 최대 5개의 제안이 표시할 수 있습니다. 또한 사용하는 각 구분 기호는 제안을 대신하고 표시할 수 있는 제안 수를 낮춥니다.