interface ICoreWebView2ExperimentalSettings2

[アーティクル]
06/04/2021

Note

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

Note

This an experimental API that is shipped with our prerelease SDK. See WebView2 release notes.

interface ICoreWebView2ExperimentalSettings2
  : public IUnknown

The ICoreWebView2Settings Experimental interface for AreBrowserAcceleratorKeysEnabled.

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	N/A
WebView2 Win32 Prerelease	1.0.824

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 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 navigation.",
                    L"Settings change", MB_OK);
            }

put_AreBrowserAcceleratorKeysEnabled

Sets the AreBrowserAcceleratorKeysEnabled property.

public HRESULT put_AreBrowserAcceleratorKeysEnabled(BOOL areBrowserAcceleratorKeysEnabled)

次の方法で共有