WebUISearchActivatedEventArgs, classe
TOC
Réduire la table des matières
Développer la table des matières

WebUISearchActivatedEventArgs 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.

C#/C++/VB:  Ce type apparaît sous forme de SearchActivatedEventArgs.

Syntaxe


/* Pour plus d'informations sur la création ou l'accès à cet objet, consultez les notes. */

Attributs

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

Membres

WebUISearchActivatedEventArgsClasse possède ces types de membres :

Méthodes

The WebUISearchActivatedEventArgs Classe hérite des méthodes de Object Classe (C#/VB/C++).

Propriétés

Le WebUISearchActivatedEventArgsClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

ActivatedOperation

En lecture seuleGets the app activated operation.

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 the splash screen 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 webUISearchActivatedEventArgs est passé au gestionnaire d'événements onactivated de votre application lorsque l'utilisateur recherche l'application à partir du symbole 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.

Remarque   : cette classe n'est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d'informations, consultez Threads et marshaling (C++/CX).

Exemples

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


function activated(eventObject) {
    if (eventObject.detail.kind === Windows.ApplicationModel.Activation.ActivationKind.launch) {
        // Use setPromise to indicate to the system that the splash screen must not be torn down
        // until after processAll and navigate complete asynchronously.
        eventObject.setPromise(WinJS.UI.processAll().then(function () {
            // Navigate to either the first scenario or to the last running scenario
            // before suspension or termination.
            var url = WinJS.Application.sessionState.lastUrl || scenarios[0].url;
            return WinJS.Navigation.navigate(url);
        }));
    } else if (eventObject.detail.kind === Windows.ApplicationModel.Activation.ActivationKind.search) {
        // Use setPromise to indicate to the system that the splash screen must not be torn down
        // until after processAll and navigate complete asynchronously.
        eventObject.setPromise(WinJS.UI.processAll().then(function () {
            if (eventObject.detail.queryText === "") {
                // Navigate to your landing page since the user is pre-scoping to your app.
            } else {
                // Display results in UI for eventObject.detail.queryText and eventObject.detail.language.
                // eventObject.detail.language represents user's locale.
            }
            // Navigate to the first scenario since it handles search activation.
            var url = scenarios[0].url;
            return WinJS.Navigation.navigate(url, { searchDetails: eventObject.detail });
        }));
    }
}

En JavaScript, eventObject contient un objet webUISearchActivatedEventArgs.

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]

Espace de noms

Windows.UI.WebUI

Métadonnées

Windows.winmd

Voir aussi

Exemple de contrat de recherche

 

 

Afficher:
© 2016 Microsoft