DTM_NAVIGATE

4/8/2010

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 Value

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("http://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

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

See Also

Reference

HTML Control API Messages
DTM_STOP
NM_HTMLVIEWA
NM_BEFORENAVIGATE
NM_DOCUMENTCOMPLETE
NM_NAVIGATECOMPLETE