SearchActivatedEventArgs Classe

Définition

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 : 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
Héritage
Object Platform::Object IInspectable SearchActivatedEventArgs
Attributs
Implémente

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.

S’applique à

Voir aussi