Condividi tramite


SearchPane Classe

Definizione

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.Deprecated("SearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, Windows.ApplicationModel.Search.SearchContract)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class SearchPane final
/// [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.Deprecated("SearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, typeof(Windows.ApplicationModel.Search.SearchContract))]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class SearchPane
[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

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.

Si applica a

Vedi anche