DWebBrowserEvents2::DocumentComplete Method

---

Notifies an application that a document has reached the READYSTATE_COMPLETE state.

Syntax

void DocumentComplete(
    IDispatch *pDisp,
    Variant *URL
);

Parameters

pDisp

[in] Address of the IDispatch interface for the WebBrowser object that represents the window or frame in which the document has loaded. This interface can be queried for the IWebBrowser2 interface.

URL

[in] String expression that evaluates to the URL, UNC file name, or PIDL that was navigated to. Note that this URL can be different from the URL that the browser was told to navigate to. One reason is that this URL is the canonicalized and qualified URL. For example, if an application specified a URL of "www.microsoft.com" in a call to the Navigate or Navigate2 method, the URL passed by DocumentComplete would be "http://www.microsoft.com/". Also, if the server has redirected the browser to a different URL, the redirected URL will be reflected here.

Return Value

No return value.

Remarks

The URL parameter can be a PIDL in the case of a shell namespace entity for which there is no URL representation.

In the case of a document that contains multiple frames, each frame will fire this event. The top-level frame will fire this event with a pDisp value equivalent to the corresponding top-level WebBrowser object.

Not every frame will fire this event, but each frame that fires a DownloadBegin event will fire a corresponding DocumentComplete event.

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0

See Also

READYSTATE, Microsoft Knowledge Base HOWTO: Determine When a Page Is Done Loading in WebBrowser Control