SearchSuggestionCollection.AppendResultSuggestion Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt ein vorgeschlagenes Suchergebnis an die Liste der Vorschläge an, die im Suchbereich angezeigt werden sollen.
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)Parameter
- text
-
String
Platform::String
winrt::hstring
Der Text des vorgeschlagenen Ergebnisses.
- detailText
-
String
Platform::String
winrt::hstring
Der Detailtext für das vorgeschlagene Ergebnis.
- tag
-
String
Platform::String
winrt::hstring
Das eindeutige Tag, das dieses vorgeschlagene Ergebnis identifiziert.
Wenn dieses vorgeschlagene Ergebnis vom Benutzer ausgewählt wird, tritt ein ResultSuggestionChosen-Ereignis auf. Wenn die App dieses Ereignis behandelt, kann sie das Tag des ausgewählten Ergebnisvorschlags aus der SearchPaneResultSuggestionChosenEventArgs.Tag-Eigenschaft abrufen.
Das Bild, das den Ergebnisvorschlag begleitet. Das Bild sollte 40 x 40 sein. Fenster skalieren oder zuschneiden kleinere oder größere Bilder.
- imageAlternateText
-
String
Platform::String
winrt::hstring
Der alternative Text für das Bild.
Hinweise
Wichtig
Verwenden Sie AutoSuggestBox, um die Suche in einer App für Windows 10 oder höher zu implementieren. Weitere Informationen finden Sie im Feld für automatische Vorschläge .
Sie sollten keine Windows.ApplicationModel.Search-APIs (SearchPane, SearchContract) oder SearchBox-APIs in Apps für Windows 10 oder höher verwenden.
Sie sollten Ergebnisvorschläge anstelle von Abfragevorschlägen nur verwenden, um Ergebnisse mit hoher Zuverlässigkeit anzuzeigen, die den Benutzer direkt zum Element anstatt zu einer Ansicht führen, die Suchergebnisse anzeigt.
Die vorgeschlagenen Ergebnisse enthalten ein Bild und optionalen Detailtext, der mit dem Vorschlag im Suchbereich angezeigt werden soll. Das Bild signalisiert dem Benutzer, dass ergebnisse und keine Abfragevorschläge angezeigt werden. Wenn kein Bild für das Ergebnis vorhanden ist, können Sie ein generisches Bild oder Symbol verwenden, das das Ergebnis oder den Ergebnistyp darstellt.
Sie müssen das ResultSuggestionChosen-Ereignis überwachen und behandeln, wenn Sie Ergebnisvorschläge bereitstellen möchten.
Im Suchbereich können maximal fünf Vorschläge angezeigt werden. Darüber hinaus tritt jedes verwendete Trennzeichen an die Stelle eines Vorschlags und verringert die Anzahl der Vorschläge, die Sie anzeigen können.