description | title | ms.date | keywords | topic_type | api_name | api_type | api_location | ||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
A continuation of the ICoreWebView2Settings interface that manages whether browser accelerator keys are enabled. |
WebView2 Win32 C++ ICoreWebView2Settings3 |
05/28/2024 |
IWebView2, IWebView2WebView, webview2, webview, win32 apps, win32, edge, ICoreWebView2, ICoreWebView2Controller, browser control, edge html, ICoreWebView2Settings3 |
|
|
|
|
interface ICoreWebView2Settings3
: public ICoreWebView2Settings2
A continuation of the ICoreWebView2Settings interface that manages whether browser accelerator keys are enabled.
Members | Descriptions |
---|---|
get_AreBrowserAcceleratorKeysEnabled | When this setting is set to FALSE, it disables all accelerator keys that access features specific to a web browser, including but not limited to: |
put_AreBrowserAcceleratorKeysEnabled | Sets the AreBrowserAcceleratorKeysEnabled property. |
Product | Introduced |
---|---|
WebView2 Win32 | 1.0.864.35 |
WebView2 Win32 Prerelease | 1.0.865 |
When this setting is set to FALSE, it disables all accelerator keys that access features specific to a web browser, including but not limited to:
public HRESULT get_AreBrowserAcceleratorKeysEnabled(BOOL * areBrowserAcceleratorKeysEnabled)
-
Ctrl-F and F3 for Find on Page
-
Ctrl-P for Print
-
Ctrl-R and F5 for Reload
-
Ctrl-Plus and Ctrl-Minus for zooming
-
Ctrl-Shift-C and F12 for DevTools
-
Special keys for browser functions, such as Back, Forward, and Search
It does not disable accelerator keys related to movement and text editing, such as:
-
Home, End, Page Up, and Page Down
-
Ctrl-X, Ctrl-C, Ctrl-V
-
Ctrl-A for Select All
-
Ctrl-Z for Undo
Those accelerator keys will always be enabled unless they are handled in the AcceleratorKeyPressed
event.
This setting has no effect on the AcceleratorKeyPressed
event. The event will be fired for all accelerator keys, whether they are enabled or not.
The default value for AreBrowserAcceleratorKeysEnabled
is TRUE.
CHECK_FEATURE_RETURN(m_settings3);
BOOL enabled;
CHECK_FAILURE(m_settings3->get_AreBrowserAcceleratorKeysEnabled(&enabled));
if (enabled)
{
CHECK_FAILURE(m_settings3->put_AreBrowserAcceleratorKeysEnabled(FALSE));
MessageBox(
nullptr,
L"Browser-specific accelerator keys will be disabled after the next "
L"navigation.",
L"Settings change", MB_OK);
}
else
{
CHECK_FAILURE(m_settings3->put_AreBrowserAcceleratorKeysEnabled(TRUE));
MessageBox(
nullptr,
L"Browser-specific accelerator keys will be enabled after the next "
L"navigation.",
L"Settings change", MB_OK);
}
Sets the AreBrowserAcceleratorKeysEnabled
property.
public HRESULT put_AreBrowserAcceleratorKeysEnabled(BOOL areBrowserAcceleratorKeysEnabled)