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.
The system provides a default implementation.
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. |
Windows NT: Use version 5.0 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in hlink.h.
HlinkCreateBrowseContext, IHlink, IHlinkFrame, IHlinkTarget