Windows Dev Center

SearchActivatedEventArgs Class

Fournit des informations sur l'événement activé qui se déclenche lorsque l'utilisateur recherche l'application à partir de la fonction de recherche et que l'application n'est pas l'application principale sur l'écran.

JavaScript:  Ce type apparaît sous forme de webUISearchActivatedEventArgs.

Syntaxe


public sealed class SearchActivatedEventArgs : ISearchActivatedEventArgs,
    IActivatedEventArgs,
    IApplicationViewActivatedEventArgs,
    ISearchActivatedEventArgsWithLinguisticDetails

Attributs

[MarshalingBehavior(Agile)]
[Version(0x06020000)]

Membres

SearchActivatedEventArgsClasse possède ces types de membres :

Méthodes

The SearchActivatedEventArgs Classe hérite des méthodes de Object Classe.

Propriétés

Le SearchActivatedEventArgsClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

CurrentlyShownApplicationViewId

En lecture seuleGets the identifier for the currently shown app view.

Kind

En lecture seuleGets the activation type.

Language

En lecture seuleGets the Internet Engineering Task Force (IETF) language tag (BCP 47 standard) that identifies the language currently associated with the user's text input device.

LinguisticDetails

En lecture seuleGets a SearchPaneQueryLinguisticDetails object that provides info about query text that the user enters through an Input Method Editor (IME).

PreviousExecutionState

En lecture seuleGets the execution state of the app before it was activated.

QueryText

En lecture seuleGets the text that the user wants the app to search for.

SplashScreen

En lecture seuleGets a SplashScreen object that provides information about the transition from the splash screen to the activated app.

 

Remarques

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 de recherche 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.

Pour savoir comment permettre aux utilisateurs d'effectuer des recherches à l'aide de votre application, consultez Démarrage rapide : ajout de la recherche. Apprenez à répondre à d'autres événements liés à la recherche et à personnaliser la fenêtre de recherche et les suggestions à l'aide de la classe SearchPane de la référence d'espace de noms Windows.ApplicationModel.Search.

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

Exemples

L'Exemple de contrat de recherche montre comment répondre à un événement activé Search.

Remarque  Window.Activate est appelé dans la méthode privée EnsureMainPageActivatedAsync, non affichée.

()

async protected override void OnSearchActivated(SearchActivatedEventArgs args)
{
    await EnsureMainPageActivatedAsync(args);
    if (args.QueryText == "")
    {
        // Navigate to landing page.
    }
    else
    {
        // Display search results.
        MainPage.Current.ProcessQueryText(args.QueryText);
    }
}

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Téléphone minimal pris en charge

Windows Phone 8

Espace de noms

Windows.ApplicationModel.Activation
Windows::ApplicationModel::Activation [C++]

Métadonnées

Windows.winmd

Voir aussi

Démarrage rapide : ajout de la recherche
Démarrage rapide : appel des API asynchrones
Application
OnSearchActivated
Exemple de contrat de recherche
Référence générale
ActivationKind enumeration
Windows.ApplicationModel.Search namespace
Windows.ApplicationModel.Search.SearchPane class
Référence d'application JavaScript
Windows.UI.WebUI.WebUIApplication.Activated event
Référence d'application C#/C++/VB
OnSearchActivated
Windows.UI.Core.CoreApplicationView.Activated event

 

 

Afficher:
© 2015 Microsoft