WebBrowser.AllowWebBrowserDrop Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets a value indicating whether the WebBrowser control navigates to documents that are dropped onto it.
public:
property bool AllowWebBrowserDrop { bool get(); void set(bool value); };
public bool AllowWebBrowserDrop { get; set; }
member this.AllowWebBrowserDrop : bool with get, set
Public Property AllowWebBrowserDrop As Boolean
Property Value
true
if the control accepts documents that are dropped onto it; otherwise, false
. The default is true
.
Exceptions
This WebBrowser instance is no longer valid.
A reference to an implementation of the IWebBrowser2
interface could not be retrieved from the underlying ActiveX WebBrowser
control.
Examples
The following code example demonstrates how to use the AllowWebBrowserDrop property.
webBrowser1.AllowWebBrowserDrop = false;
webBrowser1.AllowWebBrowserDrop = False
Remarks
By default, the WebBrowser control automatically navigates to documents that are dropped onto it. This behavior is useful when you use the control as a generic browser. If you use the control to display content designed specifically for your application, such as HTML-based user assistance, set the AllowWebBrowserDrop property to false
to prevent the display of other content. This is particularly useful when you want to conceal the fact that you are using the WebBrowser control, for example to create a user interface that seamlessly combines Web-based controls with Windows Forms controls.
You can disable other standard browser features by setting the WebBrowserShortcutsEnabled and IsWebBrowserContextMenuEnabled properties to false
.
Note
This property is not related to the Control.AllowDrop property and does not cause drag-and-drop events such as the Control.DragDrop event to occur for the control.