interface ICoreWebView2Settings3

Article
11/18/2024

interface ICoreWebView2Settings3
  : public ICoreWebView2Settings2

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

Summary

Members	Descriptions
get_AreBrowserAcceleratorKeysEnabled	Gets the `AreBrowserAcceleratorKeysEnabled` property.
put_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:

Applies to

Product	Introduced
WebView2 Win32	1.0.864.35
WebView2 Win32 Prerelease	1.0.865

Members

get_AreBrowserAcceleratorKeysEnabled

Gets the AreBrowserAcceleratorKeysEnabled property.

public HRESULT get_AreBrowserAcceleratorKeysEnabled(BOOL * value)

put_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 put_AreBrowserAcceleratorKeysEnabled(BOOL value)

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

Partager via