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 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 wParamflag.
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.
Copy Code | |
---|---|
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.
Copy Code | |
---|---|
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 |