Windows Dev Center

SearchActivatedEventArgs Class

Vengono fornite informazioni sull'evento attivato che viene generato quando l'utente cerca l'app tramite l'accesso alla ricerca e l'app non è l'app principale nella schermata.

JavaScript:  Questo tipo viene visualizzato come webUISearchActivatedEventArgs.

Sintassi


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

Attributi

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

Membri

SearchActivatedEventArgsClasse include questi tipi di membri:

Metodi

The SearchActivatedEventArgs Classe eredita i metodi da Object Classe.

Proprietà

Classe dispone di tali proprietà. di SearchActivatedEventArgs

ProprietàTipo di accessoDescrizione

CurrentlyShownApplicationViewId

Sola letturaGets the identifier for the currently shown app view.

Kind

Sola letturaGets the activation type.

Language

Sola letturaGets 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

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

PreviousExecutionState

Sola letturaGets the execution state of the app before it was activated.

QueryText

Sola letturaGets the text that the user wants the app to search for.

SplashScreen

Sola letturaGets a SplashScreen object that provides information about the transition from the splash screen to the activated app.

 

Note

Se l'applicazione si integra con il Contratto ricerca, un oggetto SearchActivatedEventArgs viene passato al gestore del punto di attivazione OnSearchActivated dell'applicazione quando l'utente cerca l'applicazione tramite l'accesso alla ricerca e questa non è l'applicazione principale sullo schermo. Questo tipo di attivazione viene indicato dal valore ActivationKind.Search restituito dalla proprietà Kind.

Per informazioni su come consentire agli utenti di effettuare ricerche mediante l'applicazione, leggere Guida rapida: Aggiunta di ricerca. Imparare a rispondere ad altri eventi correlati alla ricerca e a personalizzare la casella di ricerca e i suggerimenti utilizzando la classe SearchPane nel riferimento allo spazio dei nomi Windows.ApplicationModel.Search.

Tutti gli override di Application coinvolti in uno scenario di attivazione devono chiamare Window.Activate nelle relative implementazioni.

Esempi

Nell'Esempio di contratto di ricerca viene mostrato come rispondere a un evento Search attivato.

Nota  Window.Activate viene chiamato nel metodo privato EnsureMainPageActivatedAsync, non visualizzato.

()

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);
    }
}

Requisiti

Client supportato minimo

Windows 8 [Solo applicazioni Windows Store]

Server supportato minimo

Windows Server 2012 [Solo applicazioni Windows Store]

Telefono supportato minimo

Windows Phone 8

Spazio dei nomi

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

Metadati

Windows.winmd

Vedere anche

Guida introduttiva sull'aggiunta di ricerca
Guida rapida: chiamata di API asincrone
Application
OnSearchActivated
Esempio di contatta di ricerca
Riferimento generale
ActivationKind enumeration
Windows.ApplicationModel.Search namespace
Windows.ApplicationModel.Search.SearchPane class
Guida di riferimento alle app JavaScript
Windows.UI.WebUI.WebUIApplication.Activated event
Guida di riferimento alle app in C#/C++/VB
OnSearchActivated
Windows.UI.Core.CoreApplicationView.Activated event

 

 

Mostra:
© 2015 Microsoft