NM_DOCUMENTCOMPLETE

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

See Also

Reference

HTML Control API Notifications
DTM_NAVIGATE
DTM_STOP
NM_BEFORENAVIGATE
NM_NAVIGATECOMPLETE
NM_HTMLVIEWA
NM_HTMLVIEWW