WebBrowser.AllowWebBrowserDrop Property

Note: This property is new in the .NET Framework version 2.0.

Gets or sets a value indicating whether the WebBrowser control navigates to documents that are dropped onto it.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public bool AllowWebBrowserDrop { get; set; }
/** @property */
public boolean get_AllowWebBrowserDrop ()

/** @property */
public void set_AllowWebBrowserDrop (boolean value)

public function get AllowWebBrowserDrop () : boolean

public function set AllowWebBrowserDrop (value : boolean)

Property Value

true if the control accepts documents that are dropped onto it; otherwise, false. The default is true.

Exception typeCondition

ObjectDisposedException

This WebBrowser instance is no longer valid.

InvalidOperationException

A reference to an implementation of the IWebBrowser2 could not be retrieved from the underlying ActiveX WebBrowser.

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.

NoteNote

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.

The following code example demonstrates how to use the AllowWebBrowserDrop property to configure a WebBrowser control that has been added to a form.

For the complete code example, see How to: Add Web Browser Capabilities to a Windows Forms Application.

this->WebBrowser1->AllowWebBrowserDrop = false;
this->WebBrowser1->ScriptErrorsSuppressed = true;
this->WebBrowser1->WebBrowserShortcutsEnabled = false;
this->WebBrowser1->Dock = System::Windows::Forms::DockStyle::Fill;
this->WebBrowser1->IsWebBrowserContextMenuEnabled = false;


Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0
Show: