interface ICoreWebView2Settings3

  • Article 
interface ICoreWebView2Settings3
  : public ICoreWebView2Settings2

A continuation of the ICoreWebView2Settings interface that manages whether browser accelerator keys are enabled.

Summary

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.

Applies to

Product Introduced
WebView2 Win32 1.0.864.35
WebView2 Win32 Prerelease 1.0.865

Members

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:

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);
            }

put_AreBrowserAcceleratorKeysEnabled

Sets the AreBrowserAcceleratorKeysEnabled property.

public HRESULT put_AreBrowserAcceleratorKeysEnabled(BOOL areBrowserAcceleratorKeysEnabled)