IHlink Interface
Provides methods that enable a hyperlink to navigate to its target, access a display name for display purposes, and identify itself to its container and frame.
IHlink Members
GetAdditionalParams Not implemented. GetFriendlyName Gets the display name of the target. GetHlinkSite Gets the interface pointer on the site object. GetMiscStatus Gets a value that indicates whether the hyperlink is absolute or relative. GetMonikerReference Gets the moniker portion and the location portion of the target. GetStringReference Gets the name portion and the location portion of the target. GetTargetFrameName Gets the name of the target frame. Navigate Navigates to the specified target. SetAdditionalParams Not implemented. SetFriendlyName Sets the display name of the target. SetHlinkSite Sets the interface pointer on the site object. SetMonikerReference Sets the moniker reference of the target. SetStringReference Sets the name portion and the location portion of the target. SetTargetFrameName Sets the name of the target frame.
Remarks
In Windows Internet Explorer 8 and later, all IHlink interface methods are deprecated except GetMonikerReference, GetStringReference, GetTargetFrame, and GetMiscStatus.
The IHlink interface enables a Component Object Model (COM) object called a hyperlink to completely encapsulate the behavior of navigating to its target location. Hyperlinks are managed by COM hyperlink container objects, which support the IHlinkSite interface for hyperlinks in the container, and the IHlinkTarget interface for hyperlinks referring to documents or document objects in it.
A document can use the standard Hyperlink object to represent hyperlinks within itself, thus encapsulating the capability of navigating, saving, loading, dragging, dropping, cutting, and pasting hyperlinks. The standard Hyperlink object implements the IHlink interface, the IPersistStream interface, and the IDataObject interface.
The support for IPersistStream means that the Hyperlink object can be saved to a stream or loaded from a stream, and the support for IDataObject means that the object can be cut and pasted.
IHlink interfaces are typically called by an application hyperlink container as part of a user interface for creating new hyperlinks. A standard Hyperlink object can be created through the HlinkCreateFromData function, the HlinkCreateFromMoniker function, the HlinkCreateFromString function, and the OleLoadFromStream function.
Interface Information
Stock Implementation hlink.dll Custom Implementation No Inherits from IUnknown Header and IDL files hlink.h, hlink.idl Minimum availability Internet Explorer 4.0 Minimum operating systems Windows 95, Windows NT 4.0, Windows CE 2.12
