WebBrowser.DocumentCompleted Event
Assembly: System.Windows.Forms (in system.windows.forms.dll)
'Declaration Public Event DocumentCompleted As WebBrowserDocumentCompletedEventHandler 'Usage Dim instance As WebBrowser Dim handler As WebBrowserDocumentCompletedEventHandler AddHandler instance.DocumentCompleted, handler
/** @event */ public void add_DocumentCompleted (WebBrowserDocumentCompletedEventHandler value) /** @event */ public void remove_DocumentCompleted (WebBrowserDocumentCompletedEventHandler value)
JScript supports the use of events, but not the declaration of new ones.
The WebBrowser control navigates to a new document whenever one of the following properties is set or methods is called:
Handle the DocumentCompleted event to receive notification when the new document finishes loading. When the DocumentCompleted event occurs, the new document is fully loaded, which means you can access its contents through the Document, DocumentText, or DocumentStream property.
To receive notification before navigation begins, handle the Navigating event. Handling this event lets you cancel navigation if certain conditions have not been met, for example, when the user has not completely filled out a form. Handle the Navigated event to receive notification when the WebBrowser control finishes navigation and has begun loading the document at the new location.
For more information about handling events, see Consuming Events.
The following code example demonstrates the use of this event to print a document after it has fully loaded.
Private Sub PrintHelpPage() ' Create a WebBrowser instance. Dim webBrowserForPrinting As New WebBrowser() ' Add an event handler that prints the document after it loads. AddHandler webBrowserForPrinting.DocumentCompleted, New _ WebBrowserDocumentCompletedEventHandler(AddressOf PrintDocument) ' Set the Url property to load the document. webBrowserForPrinting.Url = New Uri("\\myshare\help.html") End Sub Private Sub PrintDocument(ByVal sender As Object, _ ByVal e As WebBrowserDocumentCompletedEventArgs) Dim webBrowserForPrinting As WebBrowser = CType(sender, WebBrowser) ' Print the document now that it is fully loaded. ' webBrowserForPrinting.Print() MessageBox.Show("print") ' Dispose the WebBrowser now that the task is complete. webBrowserForPrinting.Dispose() End Sub
- SecurityPermission for immediate callers to use this control. Demand value: LinkDemand; Named Permission Sets: FullTrust.
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.
Reference
WebBrowser ClassWebBrowser Members
System.Windows.Forms Namespace
WebBrowser.DocumentStream Property
WebBrowser.DocumentText Property
GoBack
GoForward
GoHome
GoSearch
Navigate
Navigated
Navigating
WebBrowser.Url Property
WebBrowserDocumentCompletedEventArgs
WebBrowserDocumentCompletedEventHandler