SearchPane.QueryChanged Event

Definition

Fires when the user changes the text in the search box.

/// [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 QueryChanged(TypedEventHandler<SearchPane, SearchPaneQueryChangedEventArgs const&> const& handler) const;

// Revoke with event_token
void QueryChanged(event_token const* cookie) const;

// Revoke with event_revoker
SearchPane::QueryChanged_revoker QueryChanged(auto_revoke_t, TypedEventHandler<SearchPane, SearchPaneQueryChangedEventArgs 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 QueryChanged(TypedEventHandler<SearchPane, SearchPaneQueryChangedEventArgs const&> const& handler) const;

// Revoke with event_token
void QueryChanged(event_token const* cookie) const;

// Revoke with event_revoker
SearchPane::QueryChanged_revoker QueryChanged(auto_revoke_t, TypedEventHandler<SearchPane, SearchPaneQueryChangedEventArgs 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,SearchPaneQueryChangedEventArgs> QueryChanged;
[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,SearchPaneQueryChangedEventArgs> QueryChanged;
function onQueryChanged(eventArgs) { /* Your code */ }
searchPane.addEventListener("querychanged", onQueryChanged);
searchPane.removeEventListener("querychanged", onQueryChanged);
- or -
searchPane.onquerychanged = onQueryChanged;
Public Custom Event QueryChanged As TypedEventHandler(Of SearchPane, SearchPaneQueryChangedEventArgs) 

Event Type

TypedEventHandler<SearchPane,SearchPaneQueryChangedEventArgs>
Attributes

Remarks

Important

To implement search in an app for Windows 10, use AutoSuggestBox. See Auto-suggest box for more info.

You should not use Windows.ApplicationModel.Search APIs (SearchPane, SearchContract) or SearchBox (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) APIs in apps for Windows 10.

Note

An app can't use both the search box (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) and the SearchPane. Using both the search box and the search pane in the same app causes the app to throw an exception with this message: "Cannot create instance of type 'Windows.UI.Xaml.Controls.SearchBox.'"

Register to be notified when this event fires by adding an event listener to the searchPane and assigning a handler function for the event. You can access information about the event with the searchPaneQueryChangedEventArgs object that is passed to your event handler.

Applies to

See also