SearchBox.QuerySubmitted Evento
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.
Ocorre quando o usuário envia uma consulta de pesquisa.
// Register
event_token QuerySubmitted(TypedEventHandler<SearchBox, SearchBoxQuerySubmittedEventArgs const&> const& handler) const;
// Revoke with event_token
void QuerySubmitted(event_token const* cookie) const;
// Revoke with event_revoker
SearchBox::QuerySubmitted_revoker QuerySubmitted(auto_revoke_t, TypedEventHandler<SearchBox, SearchBoxQuerySubmittedEventArgs const&> const& handler) const;
public event TypedEventHandler<SearchBox,SearchBoxQuerySubmittedEventArgs> QuerySubmitted;
function onQuerySubmitted(eventArgs) { /* Your code */ }
searchBox.addEventListener("querysubmitted", onQuerySubmitted);
searchBox.removeEventListener("querysubmitted", onQuerySubmitted);
- or -
searchBox.onquerysubmitted = onQuerySubmitted;
Public Custom Event QuerySubmitted As TypedEventHandler(Of SearchBox, SearchBoxQuerySubmittedEventArgs)
<SearchBox QuerySubmitted="eventhandler"/>
Tipo de evento
Exemplos
Aqui está uma definição de XAML básica para uma SearchBox e uma implementação do manipulador QuerySubmitted. Ele chama Frame.Navigate para carregar uma página de resultados de consulta de pesquisa (não mostrada) chamada SearchResultsPage1
. A referência a this/Me nos manipuladores é a instância de página que contém, como é comum para o código de manipulação de eventos de entrada na página. Você pode ver um código semelhante como parte do Início Rápido: adicionando pesquisa a um aplicativo e Permitindo que os usuários pesquisem informações em seu .
<SearchBox x:Name="mySearchBox"
FocusOnKeyboardInput="True"
QuerySubmitted="mySearchBox_QuerySubmitted"
Height="35" />
private void mySearchBox_QuerySubmitted(SearchBox sender, SearchBoxQuerySubmittedEventArgs args)
{
this.Frame.Navigate(typeof(SearchResultsPage1), args.QueryText);
}
Private Sub mySearchBox_QuerySubmitted(sender As SearchBox, args As SearchBoxQuerySubmittedEventArgs)
Me.Frame.Navigate(GetType(SearchResultsPage1), args.QueryText)
End Sub
Comentários
Manipule esse evento para que você possa obter o valor de QueryText de SearchBoxQuerySubmittedEventArgs e passá-lo como dados de navegação ao carregar uma página de resultados de pesquisa para exibir ao usuário.
Para obter um exemplo completo de como lidar com QuerySubmitted como parte de um exemplo completo que também faz sugestões de pesquisa, consulte Exemplo de controle SearchBox.
A assinatura do manipulador para QuerySubmitted usa TypedEventHandler e impõe que o parâmetro remetente seja uma instância SearchBox , não apenas Object.