interface ICoreWebView2Settings3

發行項
08/13/2024

Note

This reference is no longer being maintained. For the latest API reference, see WebView2 API Reference.

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)

共用方式為