NM_DOCUMENTCOMPLETE
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
See Also
HTML Control API Notifications | DTM_NAVIGATE | DTM_STOP | NM_BEFORENAVIGATE | NM_NAVIGATECOMPLETE | NM_HTMLVIEWA | NM_HTMLVIEWW
Send Feedback on this topic to the authors