SearchBox.QuerySubmitted 事件

定义

当用户提交搜索查询时发生。

// 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"/>

事件类型

示例

下面是 SearchBox 的基本 XAML 定义,以及 QuerySubmitted 处理程序的实现。 它调用 Frame.Navigate 来加载搜索查询结果页, (不显示在名为 SearchResultsPage1的) 。 处理程序中的 /Me 引用是包含的页面实例,这是典型的页面输入事件处理代码。 可以在 快速入门:向应用添加搜索让用户在 中搜索信息 中看到类似的代码。

<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

注解

处理此事件,以便你可以从 SearchBoxQuerySubmittedEventArgs 获取 QueryText 值,并在加载要向用户显示的搜索结果页面时将其作为导航数据传递。

有关如何将 QuerySubmitted 作为执行搜索建议的完整示例处理的完整示例,请参阅 SearchBox 控件示例

QuerySubmitted 的处理程序签名使用 TypedEventHandler ,并强制 发件人 参数为 SearchBox 实例,而不仅仅是 Object

适用于

另请参阅