CoreWebView2Controller.AcceleratorKeyPressed 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.
AcceleratorKeyPressed is raised when an accelerator key or key combo is pressed or released while the WebView is focused.
public event EventHandler<Microsoft.Web.WebView2.Core.CoreWebView2AcceleratorKeyPressedEventArgs> AcceleratorKeyPressed;
member this.AcceleratorKeyPressed : EventHandler<Microsoft.Web.WebView2.Core.CoreWebView2AcceleratorKeyPressedEventArgs>
Public Custom Event AcceleratorKeyPressed As EventHandler(Of CoreWebView2AcceleratorKeyPressedEventArgs)
A key is considered an accelerator if either of the following conditions are true:
- Ctrl or Alt is currently being held. - The pressed key does not map to a character.
A few specific keys are never considered accelerators, such as Shift. The Escape key is always considered an accelerator.
Autorepeated key events caused by holding the key down will also raise this event. Filter out the auto-repeated key events by verifying KeyEventLParam or PhysicalKeyStatus.
In windowed mode, this event is synchronous. Until you set Handled to true
or the event handler returns, the browser process is blocked and outgoing cross-process COM calls will fail with RPC_E_CANTCALLOUT_ININPUTSYNCCALL. All CoreWebView2 methods work, however.
In windowless mode, the event is asynchronous. Further input do not reach the browser until the event handler returns or Handled is set to true
, but the browser process is not blocked, and outgoing COM calls work normally.
It is recommended to set Handled to true
as early as you are able to know that you want to handle the accelerator key.