Partager via


IHlink interface

Note  The Microsoft ActiveX Hyperlink API is deprecated in Windows Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.

 

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.

Members

The IHlink interface inherits from the IUnknown interface. IHlink also has these types of members:

  • Methods

Methods

The IHlink interface has these methods.

Method Description
GetAdditionalParams
Note  The ActiveX Hyperlink API is deprecated in Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.
 
GetFriendlyName
Note   IHlink::GetFriendlyName may be altered or unavailable in subsequent versions of the operating system or product.
 
Note  The ActiveX Hyperlink API is deprecated in Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.
 

Gets the display name of the target.

GetHlinkSite
Note   IHlink::GetHlinkSite may be altered or unavailable in subsequent versions of the operating system or product.
 
Note  The ActiveX Hyperlink API is deprecated in Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.
 

Gets the interface pointer on the site object.

GetMiscStatus
Note  The ActiveX Hyperlink API is deprecated in Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.
 

Gets a value that indicates whether the hyperlink is absolute or relative.

GetMonikerReference
Note  The ActiveX Hyperlink API is deprecated in Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.
 

Gets the moniker portion and the location portion of the target.

GetStringReference
Note  The ActiveX Hyperlink API is deprecated in Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.
 

Gets the name portion and the location portion of the target.

GetTargetFrameName
Note  The ActiveX Hyperlink API is deprecated in Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.
 

Gets the name of the target frame.

Navigate
Note   IHlink::Navigate may be altered or unavailable in subsequent versions of the operating system or product.
 
Note  The ActiveX Hyperlink API is deprecated in Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.
 

Navigates to the specified target.

SetAdditionalParams
Note  The ActiveX Hyperlink API is deprecated in Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.
 
SetFriendlyName
Note   IHlink::SetFriendlyName may be altered or unavailable in subsequent versions of the operating system or product.
 
Note  The ActiveX Hyperlink API is deprecated in Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.
 

Sets the display name of the target.

SetHlinkSite
Note   IHlink::SetHlinkSite may be altered or unavailable in subsequent versions of the operating system or product.
 
Note  The ActiveX Hyperlink API is deprecated in Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.
 

Sets the interface pointer on the site object.

SetMonikerReference
Note   IHlink::SetMonikerReference may be altered or unavailable in subsequent versions of the operating system or product.
 
Note  The ActiveX Hyperlink API is deprecated in Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.
 

Sets the moniker reference of the target.

SetStringReference
Note   IHlink::SetStringReference may be altered or unavailable in subsequent versions of the operating system or product.
 
Note  The ActiveX Hyperlink API is deprecated in Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.
 

Sets the name portion and the location portion of the target.

SetTargetFrameName
Note   IHlink::SetTargetFrameName may be altered or unavailable in subsequent versions of the operating system or product.
 
Note  The ActiveX Hyperlink API is deprecated in Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.
 

Sets the name of the target frame.

 

Remarks

In Internet Explorer 8 and later, all IHlink interface methods are deprecated except IHlink::GetMonikerReference, IHlink::GetStringReference, ITargetEmbedding::GetTargetFrame, and IHlink::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.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

Hlink.h

IDL

Hlink.idl

DLL

Hlink.dll