NM_DOCUMENTCOMPLETE

Article
08/28/2006

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

Syntax

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

Parameters

pnmHTMLView
Points to an NM_HTMLVIEW structure that contains information about the DOCUMENTCOMPLETE notification message.
szURL
A null-terminated string that contains the navigation URL.

Return Values

The return value is ignored by the control.

Remarks

NM_DOCUMENTCOMPLETE is sent by SetWindowText only when the string is not NULL.

The information contained in the NM_HTMLVIEW: szTarget field returned by NM_DOCUMENTCOMPLETE is the complete navigation URL. The information contained in the NM_HTMLVIEW: szTarget field returned by NM_BEFORENAVIGATE is the navigation URL as it appeared in the SendMessage argument list before being composed into a complete and valid navigation URL.

Example

To navigate to msn.com:

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

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

The results of NM_BEFORENAVIGATE and NM_DOCUMENTCOMPLETE are the following:

NM_BEFORENAVIGATE NM_HTMLVIEW struct:szTarget=https://msn.com/
NM_DOCUMENTCOMPLETE NM_HTMLVIEW struct:szTarget=https://www.msn.com/

Requirements

Pocket PC: Pocket PC 2002 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: htmlctrl.h
Library: htmlctrl.lib