NM_DOCUMENTCOMPLETE

Article
11/18/2015

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 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 Value

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

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

Partager via