Export (0) Print
Expand All

DTM_NAVIGATE

Send Feedback

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("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

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

See Also

HTML Control API Messages | DTM_STOP | NM_HTMLVIEWA | NM_BEFORENAVIGATE | NM_DOCUMENTCOMPLETE | NM_NAVIGATECOMPLETE


Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.


Show:
© 2014 Microsoft