SearchActivatedEventArgs Classe

Définition

Espace de noms:

Windows.ApplicationModel.Activation

Fournit des informations sur l’événement activé qui se déclenche lorsque l’utilisateur recherche l’application à partir de l’icône Rechercher et que l’application n’est pas l’application principale à l’écran.

Javascript Ce type apparaît sous la forme webUISearchActivatedEventArgs.

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 : 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 : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider

Public NotInheritable Class SearchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider

Héritage

Object Platform::Object IInspectable SearchActivatedEventArgs

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

IActivatedEventArgs IApplicationViewActivatedEventArgs ISearchActivatedEventArgs ISearchActivatedEventArgsWithLinguisticDetails IViewSwitcherProvider IActivatedEventArgsWithUser

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Important

Pour implémenter la recherche dans une application pour Windows 10 ou une version ultérieure, utilisez AutoSuggestBox. Pour plus d’informations, consultez la zone de suggestion automatique.

Vous ne devez pas utiliser les API Windows.ApplicationModel.Search (SearchPane, SearchContract) ou les API SearchBox dans les applications pour Windows 10 ou une version ultérieure.

Si votre application s’intègre au contrat de recherche, un objet SearchActivatedEventArgs est passé au gestionnaire de point d’activation OnSearchActivated de votre application lorsque l’utilisateur recherche l’application à partir de l’icône Rechercher et que votre application n’est pas l’application principale à l’écran. Ce type d’activation est indiqué par la valeur ActivationKind.Search retournée par la propriété Kind .

Toutes les substitutions d’application impliquées dans un scénario d’activation doivent appeler Window.Activate dans leurs implémentations.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1607	14393	Utilisateur

Propriétés

CurrentlyShownApplicationViewId	Obtient l’identificateur de la vue d’application actuellement affichée.
Kind	Obtient le type d’activation.
Language	Obtient la balise de langue IETF (Internet Engineering Task Force) (BCP 47 standard) qui identifie la langue actuellement associée à l’appareil d’entrée de texte de l’utilisateur.
LinguisticDetails	Obtient un objet SearchPaneQueryLinguisticDetails qui fournit des informations sur le texte de requête que l’utilisateur entre via un éditeur de méthode d’entrée (IME).
PreviousExecutionState	Obtient l’état d’exécution de l’application avant son activation.
QueryText	Obtient le texte que l’utilisateur souhaite que l’application recherche. L’utilisateur a entré ce texte dans la zone de recherche du volet de recherche.
SplashScreen	Obtient un objet SplashScreen qui fournit des informations sur la transition de l’écran de démarrage à l’application activée.
User	Obtient l’utilisateur pour lequel l’application a été activée.
ViewSwitcher	Obtient l’objet sélecteur d’affichage qui vous permet de définir la vue pour l’application.

Voir aussi

• Application
• ActivationKind
• Windows.ApplicationModel.Search
• SearchPane
• Activated
• OnSearchActivated(SearchActivatedEventArgs)
• Activated
• Appeler des API asynchrones en C# ou Visual Basic
• Exemple de contrat de recherche (Windows 8)