SearchPane.SuggestionsRequested Evento

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Search

Si verifica quando il testo della query dell'utente cambia e l'app deve fornire nuovi suggerimenti da visualizzare nel riquadro di ricerca.

/// [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 SuggestionsRequested(TypedEventHandler<SearchPane, SearchPaneSuggestionsRequestedEventArgs const&> const& handler) const;

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

// Revoke with event_revoker
SearchPane::SuggestionsRequested_revoker SuggestionsRequested(auto_revoke_t, TypedEventHandler<SearchPane, SearchPaneSuggestionsRequestedEventArgs 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,SearchPaneSuggestionsRequestedEventArgs> SuggestionsRequested;

function onSuggestionsRequested(eventArgs) { /* Your code */ }
searchPane.addEventListener("suggestionsrequested", onSuggestionsRequested);
searchPane.removeEventListener("suggestionsrequested", onSuggestionsRequested);
- or -
searchPane.onsuggestionsrequested = onSuggestionsRequested;

Public Custom Event SuggestionsRequested As TypedEventHandler(Of SearchPane, SearchPaneSuggestionsRequestedEventArgs) 

Tipo evento

TypedEventHandler<SearchPane,SearchPaneSuggestionsRequestedEventArgs>

Attributi

DeprecatedAttribute

Commenti

Importante

Per implementare la ricerca in un'app per Windows 10 o versione successiva, usare AutoSuggestBox. Per altre informazioni, vedi Casella di suggerimento automatico .

Non è consigliabile usare le API Windows.ApplicationModel.Search (SearchPane, SearchContract) o SearchBox nelle app per Windows 10 o versioni successive.

Nota

Un'app non può usare sia la casella di ricerca (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) che searchPane. L'uso della casella di ricerca e del riquadro di ricerca nella stessa app fa sì che l'app generi un'eccezione con questo messaggio: "Impossibile creare un'istanza di tipo 'Windows.UI.Xaml.Controls.SearchBox'".

I suggerimenti possono provenire da tre origini: cronologia di ricerca, file locali o da un'origine specificata dall'app. I suggerimenti vengono raggruppati in base all'origine e visualizzati nell'ordine seguente nel riquadro di ricerca: cronologia di ricerca, file locali e quindi origini specificate dall'app.

Se l'app partecipa al contratto di ricerca e vuoi che l'app visualizzi i suggerimenti provenienti da origini specificate, devi registrare un gestore per rispondere quando viene generato questo evento. Nel gestore eventi SuggestionsRequested rispondere ottenendo suggerimenti e popolando SearchSuggestionCollection in base all'oggetto SearchPaneSuggestionsRequestedEventArgs dell'utente. QueryText.

Nota

Se si vuole rispondere a questo evento in modo asincrono, è necessario usare SearchPaneSuggestionsRequestedEventArgs. Richiesta. GetDeferral.

Non è possibile fornire suggerimenti per una casella di ricerca vuota, quindi questo evento non viene generato quando l'utente aggiorna la casella di ricerca in modo che sia vuota.

Tipi di suggerimenti per la ricerca

L'app può visualizzare due tipi di suggerimenti: suggerimenti che consentono agli utenti di perfezionare una query (suggerimenti per la query) e suggerimenti effettivi di una query (suggerimenti per i risultati). È possibile scegliere di visualizzare uno o entrambi i tipi di suggerimenti.

Se fornisci suggerimenti per la query e l'utente ne seleziona uno, l'app deve rispondere visualizzando i risultati per la query selezionata e perfezionata nella pagina dei risultati della ricerca dell'app.

Se si forniscono suggerimenti per i risultati, è necessario registrare anche un gestore eventi ResultSuggestionChosen in modo da poter rispondere quando l'utente seleziona uno dei suggerimenti dei risultati ed è possibile visualizzare il risultato all'utente.

Recupero di suggerimenti

Ecco alcuni esempi di origini che l'app può usare per ottenere suggerimenti:

• Da un elenco locale, statico e definito dall'app
• Da un URL che supporta i suggerimenti in formato OpenSearch

Visualizzazione dei suggerimenti forniti dall'app nel riquadro di ricerca

Dopo aver ottenuto i suggerimenti, i suggerimenti vengono visualizzati nel riquadro di ricerca aggiungendoli alla richiesta. SearchSuggestionCollection.

Al massimo, il riquadro di ricerca può visualizzare 5 suggerimenti. Se si sceglie di visualizzare sia i suggerimenti per le query che i suggerimenti dei risultati, è consigliabile raggruppare i suggerimenti in base al tipo di suggerimento (query o risultato) e separare i gruppi usando AppendSearchSeparator. Ogni separatore ha il posto di un suggerimento e deve essere seguito da almeno un suggerimento, riducendo il numero di suggerimenti che è possibile visualizzare.

Vedi anche

• SearchPane
• ResultSuggestionChosen
• SearchSuggestionCollection
• SearchPaneSuggestionsRequestedEventArgs
• SearchSuggestionCollection
• Esempio di contratto di ricerca (Windows 8)