Partilhar via


SearchActivatedEventArgs Classe

Definição

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, 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
Herança
Object Platform::Object IInspectable SearchActivatedEventArgs
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.

Aplica-se a

Confira também