DTM_NAVIGATE

Article
08/28/2006

This message is sent by an application to navigate to a particular URL or local file in the HTML control.

Syntax

DTM_NAVIGATE
  wParam = wParam;
  lParam = (LPARAM)(LPTSTR) pszURL;

Parameters

wParam
Flag specifying navigation behavior. For information about the flags you can use, see table below.
pszURL
A null-terminated string of the URL or local file to navigate the HTML control. For examples on how to format the string, see the examples below.

Return Values

None.

Remarks

Notifications are sent to the client by the NM_BEFORENAVIGATE notification with the NM_HTMLVIEWA structure when using this message. The following table lists the flags that can be used for the wParam flag.

Flag	Value	Description
NAVIGATEFLAG_REFRESH	0x0020	Forced refresh of the URL content from the server, without checking expiration time or last-modified time. Not supported for Smartphone 2002. Not supported for Pocket PC 2000 or Pocket PC 2002.
NAVIGATEFLAG_RELATIVE	0x0040	The navigation is relative to the current page Not supported for Smartphone 2002. Not supported for Pocket PC 2000 or Pocket PC 2002.
NAVIGATEFLAG_ENTERED	0x0080	The user entered the URL for the navigation. Not supported for Smartphone 2002.
NAVIGATEFLAG_IGNORETARGET	0x0200	The navigation is ignoring the TARGET attribute (if navigated via an <A HREF> tag. Not supported for Smartphone 2002. Not supported for Pocket PC 2000 or Pocket PC 2002.
NAVIGATEFLAG_GETFROMCACHE	0x0400	Load the content from the cache, without checking expiration time. Go online only if no cache. Not supported for Smartphone 2002. Not supported for Pocket PC 2000 or Pocket PC 2002.
NAVIGATEFLAG_NOCACHE	0x1000	Do not cache the content downloaded from the URL. Not supported for Smartphone 2002. Not supported for Pocket PC 2000 or Pocket PC 2002.
NAVIGATEFLAG_RESYNCHRONIZE	0x2000	Check the server to see that the most recent content is available -- this option will allow the HTML control to go online without checking the expiration time. Then, the underlying code will compare the "last-modified" time with the server, and download the more recent content, if necessary. Not supported for Smartphone 2002. Not supported for Pocket PC 2000 or Pocket PC 2002.
NAVIGATEFLAG_RELOAD	0x4000	Same as NAVIGATEFLAG_REFRESH, except that the "Referer" on the HTTP request does not get set, and the content may be loaded from the cache if it has not expired. Not supported for Smartphone 2002. Not supported for Pocket PC 2000 or Pocket PC 2002.

The following example shows how you might use this message for a URL.

SendMessage(hWndCtrl, DTM_NAVIGATE, 0, 
            (LPARAM)TEXT("https://www.proseware.com/"));

The following example shows how you might use this message for a local file.

SendMessage(hWndCtrl, DTM_NAVIGATE, 0, 
            (LPARAM)TEXT("file://\\windows\\default.htm/"));

Requirements

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