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