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。
适用于
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈