SearchActivatedEventArgs Classe

Definição

Namespace:

Windows.ApplicationModel.Activation

Fornece informações sobre o evento ativado que é acionado quando o usuário pesquisa o aplicativo no botão Pesquisar e o aplicativo não é o aplicativo principal na tela.

Javascript Esse tipo aparece como webUISearchActivatedEventArgs.

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 : 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 : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider

Public NotInheritable Class SearchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider

Herança

Object Platform::Object IInspectable SearchActivatedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

IActivatedEventArgs IApplicationViewActivatedEventArgs ISearchActivatedEventArgs ISearchActivatedEventArgsWithLinguisticDetails IViewSwitcherProvider IActivatedEventArgsWithUser

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Importante

Para implementar a pesquisa em um aplicativo para Windows 10 ou posterior, use AutoSuggestBox. Consulte Caixa de sugestão automática para obter mais informações.

Você não deve usar APIs Windows.ApplicationModel.Search (SearchPane, SearchContract) ou APIs SearchBox em aplicativos para Windows 10 ou posteriores.

Se o aplicativo se integrar ao contrato de Pesquisa, um objeto SearchActivatedEventArgs será passado para o manipulador de ponto de ativação OnSearchActivated do aplicativo quando o usuário pesquisar o aplicativo no botão Pesquisar e seu aplicativo não for o aplicativo principal na tela. Esse tipo de ativação é indicado pelo valor ActivationKind.Search retornado pela propriedade Kind .

Todas as substituições de aplicativo envolvidas em um cenário de ativação devem chamar Window.Activate em suas implementações.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	Usuário

Propriedades

CurrentlyShownApplicationViewId	Obtém o identificador para a exibição de aplicativo mostrada no momento.
Kind	Obtém o tipo de ativação.
Language	Obtém a marca de idioma IETF (Internet Engineering Task Force) (padrão BCP 47) que identifica o idioma atualmente associado ao dispositivo de entrada de texto do usuário.
LinguisticDetails	Obtém um objeto SearchPaneQueryLinguisticDetails que fornece informações sobre o texto de consulta que o usuário insere por meio de um IME (Editor de Método de Entrada).
PreviousExecutionState	Obtém o estado de execução do aplicativo antes de ser ativado.
QueryText	Obtém o texto que o usuário deseja que o aplicativo pesquise. O usuário inseriu esse texto na caixa de pesquisa do painel de pesquisa.
SplashScreen	Obtém um objeto SplashScreen que fornece informações sobre a transição da tela inicial para o aplicativo ativado.
User	Obtém o usuário para o qual o aplicativo foi ativado.
ViewSwitcher	Obtém o objeto do comutador de exibição que permite definir o modo de exibição para o aplicativo.

Confira também

• Application
• ActivationKind
• Windows.ApplicationModel.Search
• SearchPane
• Activated
• OnSearchActivated(SearchActivatedEventArgs)
• Activated
• Chamar APIs assíncronas no Visual Basic ou C#
• Amostra de contrato de pesquisa (Windows 8)