IHlinkBrowseContext

The IHlinkBrowseContext interface enables a COM object to define and manage the browsing context for an ActiveX hyperlink application.

A hyperlink browse context keeps track of the order in which the object/documents (perhaps belonging to different processes) have been visited and chains them together into a navigation stack. The context also keeps track of enabling or disabling buttons like Go Forward or Go Back for each entry in the navigation stack. In addition, the context maintains window positioning information for hyperlink targets so that a hyperlink application can provide a seamless user-interface.

Browse context objects are not required for hyperlink navigation. HlinkSimpleNavigateToString and HlinkSimpleNavigateToMoniker provide examples of navigation between hyperlink containers and hyperlink targets that do not use a browsing context.

IHlinkBrowseContext provides methods that maintain the hyperlink navigation stack and keep track of window position information.

When to Implement

The system provides a default implementation.

Methods in Vtable Order

IUnknown Methods Description
QueryInterface Returns pointers to supported interfaces.
AddRef Increments reference count.
Release Decrements reference count.

IHlinkBrowseContext Methods Description
Register Registers an object with the browse context.
GetObject Retrieves an object previously registered in the browse context under the given name.
Revoke Revokes an object previously registered with this browse context.
SetBrowseWindowInfo Establishes the browse window info structure of this browse context.
GetBrowseWindowInfo Retrieves the browse window info structure associated with this browse context.
EnumNavigationStack Retrieves an enumerator which can be used to enumerate the current contents of the navigation stack.
QueryHlink Tests the validity of a hyperlink ID value.
GetHlink Retrieves a hyperlink from this browse context.
SetCurrentHlink Sets the current hyperlink in this browse context's navigation stack.
OnNavigateHlink Notifies a browse context that a hyperlink has been navigated.
Clone Duplicates a browse context.
Close Closes the hyperlink browse context.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in hlink.h.

See Also

HlinkCreateBrowseContext, IHlink, IHlinkFrame, IHlinkTarget