IHlinkBrowseContext

IHlinkBrowseContext

The IHlinkBrowseContext interface enables a COM object to define and manage the browsing context for an OLE 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.