A hyperlink target implements the IHlinkTarget interface and gives out hyperlink references to its contents.
Implement this interface when you have an application that can be the target for a hyperlink. In other words, hyperlinks from other applications use this interface to determine how to find, display, and navigate to your target.
An existing OLE document application which supports OLE linking need only implement the IHlinkTarget interface on the same object that implements IPersistFile and IOleItemContainer. The application may also implement IPersistMoniker to support incremental rendering or asynchronous download as a persistence mechanism, rather than IPersistFile.
Note that an ActiveX Document Object need not implement this interface if hyperlink navigation is only occuring within a document object container such as Microsoft Internet Explorer. In such a situation, IHlinkTarget provides the capability to navigate to a location within the document, but it is not necessary for navigation to be completed.
You do not normally call these methods directly. When an end user selects a hyperlink through an application's user interface, the implementation of IHlink::Navigate calls these methods to determine how to display, locate, and navigate to the target.
IUnknown Methods | Description |
---|---|
QueryInterface | Returns pointers to supported interfaces. |
AddRef | Increments reference count. |
Release | Decrements reference count. |
IHlinkTarget Methods | Description |
---|---|
SetBrowseContext | Establishes the current browse context for this hyperlink target. |
GetBrowseContext | Retrieves the current browse context within which this hyperlink target is currently running. |
Navigate | If the given location is not visible, navigates to and shows that position within the target. |
GetMoniker | Returns a moniker to the hyperlink target object. |
GetFriendlyName | Returns a friendly name for the given hyperlink location within this target. |
Windows NT: Use version 5.0 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in hlink.h.
HlinkNavigate, HlinkSimpleNavigateToMoniker, HlinkSimpleNavigateToString, IHlink, IHlinkBrowseContext