SearchActivatedEventArgs Classe

Definizione

Fornisce informazioni sull'evento attivato generato quando l'utente cerca l'app dall'accesso alla ricerca e l'app non è l'app principale sullo schermo.

Javascript Questo tipo viene visualizzato come webUISearchActivatedEventArgs.

public ref class SearchActivatedEventArgs sealed : IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
public ref class SearchActivatedEventArgs sealed : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SearchActivatedEventArgs final : IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SearchActivatedEventArgs final : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SearchActivatedEventArgs : IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SearchActivatedEventArgs : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
Public NotInheritable Class SearchActivatedEventArgs
Implements IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
Public NotInheritable Class SearchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
Ereditarietà
Object Platform::Object IInspectable SearchActivatedEventArgs
Attributi
Implementazioni

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

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.

Se l'app si integra con il contratto di ricerca, un oggetto SearchActivatedEventArgs viene passato al gestore del punto di attivazione OnSearchActivated dell'app quando l'utente cerca l'app dall'accesso alla ricerca e l'app non è l'app principale sullo schermo. Questo tipo di attivazione è indicato dal valore ActivationKind.Search restituito dalla proprietà Kind .

Tutte le sostituzioni dell'applicazione coinvolte in uno scenario di attivazione devono chiamare Window.Activate nelle implementazioni.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1607 14393 Utente

Proprietà

CurrentlyShownApplicationViewId

Ottiene l'identificatore per la visualizzazione dell'app attualmente visualizzata.

Kind

Ottiene il tipo di attivazione.

Language

Ottiene il tag di lingua IETF (Internet Engineering Task Force) (standard BCP 47) che identifica la lingua attualmente associata al dispositivo di input di testo dell'utente.

LinguisticDetails

Ottiene un oggetto SearchPaneQueryLinguisticDetails che fornisce informazioni sul testo della query immesso dall'utente tramite un IME (Input Method Editor).

PreviousExecutionState

Ottiene lo stato di esecuzione dell'app prima dell'attivazione.

QueryText

Ottiene il testo che l'utente desidera cercare nell'app. L'utente ha immesso questo testo nella casella di ricerca del riquadro di ricerca.

SplashScreen

Ottiene un oggetto SplashScreen che fornisce informazioni sulla transizione dalla schermata iniziale all'app attivata.

User

Ottiene l'utente per cui è stata attivata l'app.

ViewSwitcher

Ottiene l'oggetto switcher di visualizzazione che consente di impostare la visualizzazione per l'applicazione.

Si applica a

Vedi anche