描述
当文档被完全加载和初始化时触发。
C++ 语法
void DocumentComplete( IDispatch *pDisp, VARIANT *vURL ); |
PowerBASIC 语法
METHOD DocumentComplete ( _ BYVAL pDisp AS IDispatch, _ BYREF vURL AS VARIANT _ ) |
参数
pDisp |
[in]指向文档加载的窗口或框架的IDispatch界面的指针。可以查询IWebBrowser2界面的IDispatch界面。 |
vURL |
[in]指向VT_BSTR类型的VARIANT的指针，指定URL，通用命名约定（UNC）文件名或指向加载文档的项目标识符列表（PIDL）的指针。 |
OBRESULT
无返回值。
事件DISPID
DISPID_DOCUMENTCOMPLETE
此事件的DISPID在exdispid.inc中定义。在实现IDispatch.Invoke时使用此值来标识事件处理程序。
备注
vURL参数的值可能与最初提供给WebBrowser控件的URL不匹配。一个可能的原因是URL可能会转换为合格的表单。例如，如果应用程序在调用IWebBrowser2接口的导航或Navigate2方法时指定了www.microsoft.com的URL，则传入DocumentComplete的URL为http://www.microsoft。 COM /。此外，如果服务器已将浏览器重定向到其他URL，则将重定向的URL传递到URL参数。
当文档已完全加载并且READYSTATE属性更改为READYSTATE_COMPLETE时，WebBrowser控件将触发DocumentComplete事件。关于这次事件的射击，这里有一些重点。
| · | 在没有帧的页面中，此事件在加载完成后会触发一次。 |
| · | 在加载多个帧的页面中，此事件会触发DownloadBegin事件触发的每个帧。 |
| · | 此事件的PDISP参数与此事件触发的帧的IDispatch接口指针相同。 |
| · | 在加载过程中，最高级别的帧（不一定是顶级帧）触发最终的DocumentComplete事件。此时，pDisp参数将与最高级别帧的IDispatch接口指针相同。 |
当WebBrowser控制的可见属性设置为false时，DocumentComplete不会触发。