SearchPane.ResultSuggestionChosen Ereignis

Definition

Namespace:

Windows.ApplicationModel.Search

Wird ausgelöst, wenn der Benutzer eines der vorgeschlagenen Ergebnisse auswählt, die von der App bereitgestellt und im Suchbereich angezeigt werden.

/// [add: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
/// [remove: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
// Register
event_token ResultSuggestionChosen(TypedEventHandler<SearchPane, SearchPaneResultSuggestionChosenEventArgs const&> const& handler) const;

// Revoke with event_token
void ResultSuggestionChosen(event_token const* cookie) const;

// Revoke with event_revoker
SearchPane::ResultSuggestionChosen_revoker ResultSuggestionChosen(auto_revoke_t, TypedEventHandler<SearchPane, SearchPaneResultSuggestionChosenEventArgs const&> const& handler) const;

[add: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
[remove: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
public event TypedEventHandler<SearchPane,SearchPaneResultSuggestionChosenEventArgs> ResultSuggestionChosen;

function onResultSuggestionChosen(eventArgs) { /* Your code */ }
searchPane.addEventListener("resultsuggestionchosen", onResultSuggestionChosen);
searchPane.removeEventListener("resultsuggestionchosen", onResultSuggestionChosen);
- or -
searchPane.onresultsuggestionchosen = onResultSuggestionChosen;

Public Custom Event ResultSuggestionChosen As TypedEventHandler(Of SearchPane, SearchPaneResultSuggestionChosenEventArgs) 

Ereignistyp

TypedEventHandler<SearchPane,SearchPaneResultSuggestionChosenEventArgs>

Attribute

DeprecatedAttribute

Hinweise

Wichtig

Verwenden Sie AutoSuggestBox, um die Suche in einer App für Windows 10 oder höher zu implementieren. Weitere Informationen finden Sie unter 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.

Hinweis

Eine App kann nicht sowohl das Suchfeld (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) als auch die SearchPane verwenden. Wenn Sie sowohl das Suchfeld als auch den Suchbereich in derselben App verwenden, löst die App eine Ausnahme mit der folgenden Meldung aus: "Instance vom Typ 'Windows.UI.Xaml.Controls.SearchBox'" kann nicht erstellt werden.

Wenn Ihre App am Vertrag "Suchen" teilnimmt und Vorschläge für mögliche Ergebnisse im Suchbereich anzeigt, sollten Sie einen Ereignishandler registrieren, der beim Auslösen dieses Ereignisses reagiert. Antworten Sie in Ihrem ResultSuggestionChosen-Ereignishandler, indem Sie die SearchPaneResultSuggestionChosenEventArgs abrufen. Tag des ausgewählten Ergebnisses, und verwenden Sie es, um den Benutzer zum Ergebnis in Ihrer App-Benutzeroberfläche zu bringen.

Hinweis

Wenn Sie Ergebnisvorschläge anzeigen möchten, müssen Sie auch das SuggestionsRequested-Ereignis abhören und behandeln.

Weitere Informationen

• SearchPane
• SuggestionsRequested
• SearchPaneResultSuggestionChosenEventArgs
• Beispiel für einen Suchvertrag (Windows 8)
• Object-Klasse