SearchActivatedEventArgs Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 : IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProviderpublic 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, IViewSwitcherProviderPublic NotInheritable Class SearchActivatedEventArgs
Implements IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProviderPublic NotInheritable Class SearchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider- Herança
- Atributos
- Implementações
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. |