SearchBox.QuerySubmitted 事件
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
当用户提交搜索查询时发生。
// 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。