SearchActivatedEventArgs Clase

Definición

Proporciona información sobre el evento activado que se desencadena cuando el usuario busca en la aplicación desde el acceso de búsqueda y la aplicación no es la aplicación principal en pantalla.

Javascript Este tipo aparece como 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
Herencia
Object Platform::Object IInspectable SearchActivatedEventArgs
Atributos
Implementaciones

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Importante

Para implementar la búsqueda en una aplicación para Windows 10 o posterior, use AutoSuggestBox. Consulte el cuadro Sugerencias automáticas para obtener más información.

No debe usar las API Windows.ApplicationModel.Search (SearchPane, SearchContract) ni SearchBox API en aplicaciones para Windows 10 o posterior.

Si la aplicación se integra con el contrato de búsqueda, se pasa un objeto SearchActivatedEventArgs al controlador de puntos de activación OnSearchActivated de la aplicación cuando el usuario busca la aplicación desde el acceso Buscar y la aplicación no es la aplicación principal en pantalla. Este tipo de activación se indica mediante el valor ActivationKind.Search devuelto por la propiedad Kind .

Todas las invalidaciones de aplicación implicadas en un escenario de activación deben llamar a Window.Activate en sus implementaciones.

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1607 14393 Usuario

Propiedades

CurrentlyShownApplicationViewId

Obtiene el identificador de la vista de aplicación que se muestra actualmente.

Kind

Obtiene el tipo de activación.

Language

Obtiene la etiqueta de idioma del Grupo de tareas de ingeniería de Internet (IETF) (estándar BCP 47) que identifica el idioma asociado actualmente al dispositivo de entrada de texto del usuario.

LinguisticDetails

Obtiene un objeto SearchPaneQueryLinguisticDetails que proporciona información sobre el texto de consulta que el usuario escribe a través de un Editor de métodos de entrada (IME).

PreviousExecutionState

Obtiene el estado de ejecución de la aplicación antes de activarla.

QueryText

Obtiene el texto que el usuario quiere que busque la aplicación. El usuario escribió este texto en el cuadro de búsqueda del panel de búsqueda.

SplashScreen

Obtiene un objeto SplashScreen que proporciona información sobre la transición de la pantalla de presentación a la aplicación activada.

User

Obtiene el usuario para el que se activó la aplicación.

ViewSwitcher

Obtiene el objeto modificador de vista que permite establecer la vista para la aplicación.

Se aplica a

Consulte también