interface ICoreWebView2ExperimentalController2
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 ICoreWebView2ExperimentalController2
: public IUnknown
This is the ICoreWebView2ExperimentalController2 interface.
Summary
Members | Descriptions |
---|---|
get_AllowExternalDrop | Gets the AllowExternalDrop property which is used to configure the capability that dragging objects from outside the bounds of webview2 and dropping into webview2 is allowed or disallowed. |
put_AllowExternalDrop | Sets the AllowExternalDrop property which is used to configure the capability that dragging objects from outside the bounds of webview2 and dropping into webview2 is allowed or disallowed. |
The ICoreWebView2ExperimentalController2 provides interface to enable/disable external drop.
Applies to
Product | Introduced |
---|---|
WebView2 Win32 | N/A |
WebView2 Win32 Prerelease | 1.0.1010 |
Members
get_AllowExternalDrop
Gets the AllowExternalDrop
property which is used to configure the capability that dragging objects from outside the bounds of webview2 and dropping into webview2 is allowed or disallowed.
public HRESULT get_AllowExternalDrop(BOOL * value)
The default value is TRUE.
wil::com_ptr<ICoreWebView2Controller> controller =
m_appWindow->GetWebViewController();
wil::com_ptr<ICoreWebView2ExperimentalController2> controllerExperimental =
controller.try_query<ICoreWebView2ExperimentalController2>();
if (controllerExperimental)
{
BOOL allowExternalDrop;
CHECK_FAILURE(
controllerExperimental->get_AllowExternalDrop(&allowExternalDrop));
if (allowExternalDrop)
{
CHECK_FAILURE(controllerExperimental->put_AllowExternalDrop(FALSE));
MessageBox(
nullptr, L"WebView disallows dropping files now.",
L"WebView AllowDrop property changed", MB_OK);
}
else
{
CHECK_FAILURE(controllerExperimental->put_AllowExternalDrop(TRUE));
MessageBox(
nullptr, L"WebView allows dropping files now.",
L"WebView AllowDrop property changed", MB_OK);
}
}
put_AllowExternalDrop
Sets the AllowExternalDrop
property which is used to configure the capability that dragging objects from outside the bounds of webview2 and dropping into webview2 is allowed or disallowed.
public HRESULT put_AllowExternalDrop(BOOL value)
wil::com_ptr<ICoreWebView2Controller> controller =
m_appWindow->GetWebViewController();
wil::com_ptr<ICoreWebView2ExperimentalController2> controllerExperimental =
controller.try_query<ICoreWebView2ExperimentalController2>();
if (controllerExperimental)
{
BOOL allowExternalDrop;
CHECK_FAILURE(
controllerExperimental->get_AllowExternalDrop(&allowExternalDrop));
if (allowExternalDrop)
{
CHECK_FAILURE(controllerExperimental->put_AllowExternalDrop(FALSE));
MessageBox(
nullptr, L"WebView disallows dropping files now.",
L"WebView AllowDrop property changed", MB_OK);
}
else
{
CHECK_FAILURE(controllerExperimental->put_AllowExternalDrop(TRUE));
MessageBox(
nullptr, L"WebView allows dropping files now.",
L"WebView AllowDrop property changed", MB_OK);
}
}
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for