SearchActivatedEventArgs Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
- 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. |