Travel Log Reference

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 back, forward and 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.

Interfaces

IEnumTravelLogEntry

ITravelLogEntry

ITravelLogStg

Objects

IEnumTravelLogEntry

Enumerator used to access the items stored by the travel log.

Creation/Access Functions

ITravelLogStg::EnumEntries

Interfaces Implemented

IEnumTravelLogEntry

Object Information

Header and IDL files tlogstg.h, tlogstg.idl
CLSID Not available
Minimum availability Internet Explorer 5.5
Minimum operating systems Windows NT 4.0, Windows 95, Windows CE 4.0
 

TravelLogEntry

Represents one entry in the travel log. This object can be obtained using methods in ITravelLogStg and IEnumTravelLogEntry.

Creation/Access Functions

ITravelLogStg::CreateEntry
ITravelLogStg::GetRelativeEntry
IEnumTravelLogEntry::Next

Interfaces Implemented

ITravelLogEntry
IPropertyBag

Object Information

Header and IDL files tlogstg.h, tlogstg.idl
CLSID Not available
Minimum availability Internet Explorer 5.5
Minimum operating systems Windows NT 4.0, Windows 95, Windows CE 4.0
 

TravelLogStg

Represents a travel log storage object. Obtain the object by calling QueryService on the top-level browser using SID_STravelLogCursor. SID_STravelLogCursor is defined in tlogstg.h.

Interfaces Implemented

ITravelLogStg

Object Information

Header and IDL files tlogstg.h, tlogstg.idl
CLSID Not available
Minimum availability Internet Explorer 5.5
Minimum operating systems Windows NT 4.0, Windows 95, Windows CE 4.0
 

Enumerations

TLENUMF

Used to describe a travel log enumeration.

%TLEF_RELATIVE_INCLUDE_CURRENT = &H00000001
' Enumeration should include the current travel log entry.
%TLEF_RELATIVE_BACK = &H00000010
' Enumeration should include entries before the current entry.
%TLEF_RELATIVE_FORE = &H00000020
' Enumeration should include entries after the current entry.
%TLEF_INCLUDE_UNINVOKEABLE = &H00000040
' Enumeration should include entries which cannot be navigated to.
%TLEF_ABSOLUTE = &H00000031
' Enumeration should include all invokable entries.