This section describes Travel Log technology. The travel log interfaces are designed for use by an application which hosts a WebBrowser Control. Use the travel log interfaces to design applications that improve and enhance the user's travel log experience. The following list gives some examples of features you may include.
- Enumerating the travel log (forward and back).
- Navigating to specific entries in the travel log.
- Deleting and adding entries which meet certain criteria.
- Marking an entry in the travel log and then displaying the entry in red.
- Associating properties with entries in the travel log.
- Retrieving information about the state of the travel log. For example, you could show the previous five pages visited.
- Setting and retrieving custom data concerning entries in the travel log through IPropertyBag.
All the travel log interfaces act on existing data. That means that when you add or remove an entry, the change is propagated to all the methods that use the travel log (navigation stack), such as DHTML IOmHistory::back, IOmHistory::forward and IOmHistory::go.
The topmost entry in the travel log will not contain complete information until the user has navigated away from the page at least once. For example, if a user navigates to www.fabrikaminc.com and then to fabrikaminc.fabrikam.com, and a call is made to ITravelLogStg::GetRelativeEntry, the entry will not be complete. An entry is not complete until the user leaves a site—navigates from www.awesomecomputers.com to www.hansonbrothers.com, for instance—or until the user clicks the back button and then the forward button.
The following topics contain the Travel Log technology reference.