Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

This notification message is sent by the HTML viewer control when the document navigation is complete. This message is sent by the SetWindowTextfunction.

Syntax

NM_DOCUMENTCOMPLETE
NM_HTMLVIEW * 
pnmHTMLView = (NM_HTMLVIEW *)lParam;
szURL = pnmHTMLView->szTarget;

Parameters

pnmHTMLView

Points to an NM_HTMLVIEWstructure that contains information about the DOCUMENTCOMPLETE notification message.

szURL

A null-terminated string that contains the navigation URL.

Return Value

The return value is ignored by the control.

Remarks

NM_DOCUMENTCOMPLETEis sent by SetWindowTextonly when the string is not NULL.

The information contained in the NM_HTMLVIEW: szTargetfield returned by NM_DOCUMENTCOMPLETEis the complete navigation URL. The information contained in the NM_HTMLVIEW: szTargetfield returned by NM_BEFORENAVIGATEis the navigation URL as it appeared in the SendMessageargument list before being composed into a complete and valid navigation URL.

Example

To navigate to msn.com:

Copy Code
SendMessage(g_hWndCtrl, DTM_NAVIGATE, 0,
(LPARAM)TEXT("http://msn.com/);

to navigate to http://www.msn.com.

The results of NM_BEFORENAVIGATEand NM_DOCUMENTCOMPLETEare the following:

Copy Code
NM_BEFORENAVIGATE NM_HTMLVIEW struct:szTarget=http://msn.com/
NM_DOCUMENTCOMPLETE NM_HTMLVIEW struct:szTarget=http://www.msn.com/

Requirements

Header htmlctrl.h
Library htmlctrl.lib
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also