SearchBox.PrepareForFocusOnKeyboardInput Event
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Occurs when the FocusOnKeyboardInput property is true and the app receives textual keyboard input.
// Register
event_token PrepareForFocusOnKeyboardInput(TypedEventHandler<SearchBox, RoutedEventArgs const&> const& handler) const;
// Revoke with event_token
void PrepareForFocusOnKeyboardInput(event_token const* cookie) const;
// Revoke with event_revoker
SearchBox::PrepareForFocusOnKeyboardInput_revoker PrepareForFocusOnKeyboardInput(auto_revoke_t, TypedEventHandler<SearchBox, RoutedEventArgs const&> const& handler) const;
public event TypedEventHandler<SearchBox,RoutedEventArgs> PrepareForFocusOnKeyboardInput;
function onPrepareForFocusOnKeyboardInput(eventArgs) { /* Your code */ }
searchBox.addEventListener("prepareforfocusonkeyboardinput", onPrepareForFocusOnKeyboardInput);
searchBox.removeEventListener("prepareforfocusonkeyboardinput", onPrepareForFocusOnKeyboardInput);
- or -
searchBox.onprepareforfocusonkeyboardinput = onPrepareForFocusOnKeyboardInput;
Public Custom Event PrepareForFocusOnKeyboardInput As TypedEventHandler(Of SearchBox, RoutedEventArgs)
<SearchBox PrepareForFocusOnKeyboardInput="eventhandler"/>
This event occurs only if the FocusOnKeyboardInput property is true. If you wan to provide "type-to-search" behavior in your app, you should handle this event and synchronously ensure the SearchBox control is visible before the event call completes. After this event occurs, the control sets focus to itself.
When FocusOnKeyboardInput is true, keyboard input on the current thread is intercepted and textual input is redirected to the SearchBox. Only textual input will cause the SearchBox to receive focus. Non-text keys, such as arrows or Tab, are not redirected to the SearchBox. WIN/CTRL/ALT key combinations (except for Ctrl-V for paste) are also not redirected.