interface ICoreWebView2Settings6

interface ICoreWebView2Settings6
  : public ICoreWebView2Settings5

A continuation of the ICoreWebView2Settings interface to manage swipe navigation.

Summary

Applies to

Members

get_IsSwipeNavigationEnabled

Gets the IsSwipeNavigationEnabled property.

public HRESULT get_IsSwipeNavigationEnabled(BOOL * value)

put_IsSwipeNavigationEnabled

The IsSwipeNavigationEnabled property enables or disables the ability of the end user to use swiping gesture on touch input enabled devices to navigate in WebView2.

public HRESULT put_IsSwipeNavigationEnabled(BOOL value)

It defaults to TRUE.

When this property is TRUE, then all configured navigation gestures are enabled:

1. Swiping left and right to navigate forward and backward is always configured.

2. Swiping down to refresh is off by default and not exposed via our API currently, it requires the "--pull-to-refresh" option to be included in the additional browser arguments to be configured. (See put_AdditionalBrowserArguments.)

When set to FALSE, the end user cannot swipe to navigate or pull to refresh. This API only affects the overscrolling navigation functionality and has no effect on the scrolling interaction used to explore the web content shown in WebView2.

Disabling/Enabling IsSwipeNavigationEnabled takes effect after the next navigation.

            CHECK_FEATURE_RETURN(m_settings6);
            BOOL swipeNavigationEnabled;
            CHECK_FAILURE(m_settings6->get_IsSwipeNavigationEnabled(&swipeNavigationEnabled));
            if (swipeNavigationEnabled)
            {
                CHECK_FAILURE(m_settings6->put_IsSwipeNavigationEnabled(FALSE));
                MessageBox(
                    nullptr, L"Swipe to navigate is disabled after the next navigation.",
                    L"Settings change", MB_OK);
            }
            else
            {
                CHECK_FAILURE(m_settings6->put_IsSwipeNavigationEnabled(TRUE));
                MessageBox(
                    nullptr, L"Swipe to navigate is enabled after the next navigation.",
                    L"Settings change", MB_OK);
            }