SearchPane.QuerySubmitted Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возникает, когда пользователь отправляет текст в поле поиска и приложение должно отображать результаты поиска.
/// [add: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, Windows.ApplicationModel.Search.SearchContract)]
/// [remove: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, Windows.ApplicationModel.Search.SearchContract)]
// Register
event_token QuerySubmitted(TypedEventHandler<SearchPane, SearchPaneQuerySubmittedEventArgs const&> const& handler) const;
// Revoke with event_token
void QuerySubmitted(event_token const* cookie) const;
// Revoke with event_revoker
SearchPane::QuerySubmitted_revoker QuerySubmitted(auto_revoke_t, TypedEventHandler<SearchPane, SearchPaneQuerySubmittedEventArgs const&> const& handler) const;
/// [add: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
/// [remove: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
// Register
event_token QuerySubmitted(TypedEventHandler<SearchPane, SearchPaneQuerySubmittedEventArgs const&> const& handler) const;
// Revoke with event_token
void QuerySubmitted(event_token const* cookie) const;
// Revoke with event_revoker
SearchPane::QuerySubmitted_revoker QuerySubmitted(auto_revoke_t, TypedEventHandler<SearchPane, SearchPaneQuerySubmittedEventArgs const&> const& handler) const;
[add: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, typeof(Windows.ApplicationModel.Search.SearchContract))]
[remove: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, typeof(Windows.ApplicationModel.Search.SearchContract))]
public event TypedEventHandler<SearchPane,SearchPaneQuerySubmittedEventArgs> QuerySubmitted;
[add: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
[remove: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
public event TypedEventHandler<SearchPane,SearchPaneQuerySubmittedEventArgs> QuerySubmitted;
function onQuerySubmitted(eventArgs) { /* Your code */ }
searchPane.addEventListener("querysubmitted", onQuerySubmitted);
searchPane.removeEventListener("querysubmitted", onQuerySubmitted);
- or -
searchPane.onquerysubmitted = onQuerySubmitted;
Public Custom Event QuerySubmitted As TypedEventHandler(Of SearchPane, SearchPaneQuerySubmittedEventArgs)
Тип события
- Атрибуты
Комментарии
Важно!
Чтобы реализовать поиск в приложении для Windows 10 или более поздней версии, используйте AutoSuggestBox. Дополнительные сведения см. в разделе Поле автозаполнения .
Не следует использовать API Windows.ApplicationModel.Search (SearchPane, SearchContract
) или API SearchBox в приложениях для Windows 10 или более поздних версий.
Примечание
Приложение не может использовать одновременно поле поиска (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) и SearchPane. Использование поля поиска и области поиска в одном приложении приводит к тому, что приложение выдает исключение с сообщением "Не удается создать экземпляр типа Windows.UI.Xaml.Controls.SearchBox".
Если приложение участвует в контракте поиска, зарегистрируйте обработчик событий, чтобы реагировать на событие. В обработчике событий QuerySubmitted отреагируйте, переведите пользователя на страницу результатов поиска и заполните ее результатами на основе SearchPaneQuerySubmittedEventArgs. QueryText.