SearchPane Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Search

Deprecato. Usare invece il controllo Windows.UI.Xaml.Controls.AutoSuggestBox . Rappresenta e gestisce il riquadro di ricerca che viene aperto quando un utente attiva l'accesso alla ricerca.

public ref class SearchPane sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Search.SearchContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Deprecated("SearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
class SearchPane final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Search.SearchContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Deprecated("SearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
public sealed class SearchPane

Public NotInheritable Class SearchPane

Ereditarietà

Object Platform::Object IInspectable SearchPane

Attributi

ContractVersionAttribute DeprecatedAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows Desktop Extension SDK (è stato introdotto in 10.0.10240.0) Xbox One Extensions for the UWP (è stato introdotto in 10.0.10586.0)
API contract	Windows.ApplicationModel.Search.SearchContract (è stato introdotto in v1.0)

Commenti

Importante

Per implementare la ricerca in un'app per Windows 10 o versioni successive, usare AutoSuggestBox. Per altre informazioni, vedere Casella di suggerimento automatico .

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

Nota

Un'app non può usare la casella di ricerca (Windows.UI.Xaml.Controls.SearchBoxWinJS.UI.SearchBox/) e SearchPane. Usando sia la casella di ricerca che il riquadro di ricerca nella stessa app, l'app genera un'eccezione con questo messaggio: "Impossibile creare un'istanza di tipo 'Windows.UI.Xaml.Controls.SearchBox'"

Questo oggetto è disponibile per le app che partecipano al contratto di ricerca. Per fornire agli utenti risultati della ricerca, è necessario aggiungere codice al gestore eventi Attivato che risponde quando l'app viene attivata per la ricerca. Per altre informazioni sulla risposta agli eventi di attivazione della ricerca , vedere webUISearchActivatedEventArgs (JavaScript) o SearchActivatedEventArgs (C#/C++/VB).

È possibile visualizzare esempi di codice che illustrano come rispondere agli eventi di ricerca e gestire il riquadro di ricerca nell'esempio di contratto di ricerca (Windows 8).

Proprietà

Language	Tag di lingua IETF (Internet Engineering Task Force) (BCP 47 standard) che identifica la lingua attualmente associata al dispositivo di input di testo dell'utente.
PlaceholderText	Testo segnaposto nella casella di ricerca quando l'utente non ha immesso caratteri.
QueryText	Testo corrente nella casella di ricerca del riquadro di ricerca.
SearchHistoryContext	Stringa che identifica il contesto della ricerca e viene usata per archiviare la cronologia di ricerca dell'utente con l'app.
SearchHistoryEnabled	Indica se le ricerche precedenti dell'utente con l'app vengono rilevate automaticamente e usate per fornire suggerimenti.
ShowOnKeyboardInput	Ottiene o imposta se l'utente può aprire il riquadro di ricerca digitando.
Visible	Indica se il riquadro di ricerca è aperto.

Metodi

GetForCurrentView()	Recupera un'istanza del riquadro di ricerca da cui gli utenti possono cercare all'interno dell'app.
HideThisApplication()	Nasconde l'interfaccia utente dell'app corrente.
SetLocalContentSuggestionSettings(LocalContentSuggestionSettings)	Specifica se i suggerimenti basati sui file locali vengono visualizzati automaticamente nel riquadro di ricerca e definisce i criteri usati da Windows per individuare e filtrare questi suggerimenti.
Show()	Mostra il riquadro di ricerca.
Show(String)	Mostra il riquadro di ricerca con la stringa di query iniziale specificata.
TrySetQueryText(String)	Tenta di impostare il testo nella casella di ricerca del riquadro di ricerca.

Eventi

QueryChanged	Viene generato quando l'utente modifica il testo nella casella di ricerca.
QuerySubmitted	Viene generato quando l'utente invia il testo nella casella di ricerca e l'app deve visualizzare i risultati della ricerca.
ResultSuggestionChosen	Viene generato quando l'utente seleziona uno dei risultati suggeriti forniti dall'app e visualizzati nel riquadro di ricerca.
SuggestionsRequested	Si verifica quando il testo della query dell'utente cambia e l'app deve fornire nuovi suggerimenti da visualizzare nel riquadro di ricerca.
VisibilityChanged	Viene generato quando l'utente apre o chiude il riquadro di ricerca.

Vedi anche

• GetForCurrentView()
• ActivationKind
• SearchActivatedEventArgs
• Activated
• Esempio di contratto di ricerca (Windows 8)
• Gestire l’attivazione dell’app