IHlinkFrame  Interface

IID_IHlinkFrame

{79EAC9C5-BAF9-11CE-8C82-00AA004BA90B}

This interface provides methods that allow a browser to insert a hyperlink frame in the navigation process. By using the IHlinkFrame methods, you can provide a seamless interface for users when they navigate from one document, object, or application to another.

The IHlinkFrame methods usually are not called directly. Instead they are referenced by the IHlink::Navigate methods when a hyperlink frame is detected.
 

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IHlinkFrame Methods

Description

SetBrowserContext

Sets the browse context of the hyperlink frame.

GetBrowserContext

Retrieves the browse context of the hyperlink frame.

Navigate

Navigates to the target hyperlink.

OnNavigate

Notifies the hyperlink frame about a hyperlink navigation.

UpdateHlink

Updates the hyperlink frame.

SetBrowseContext

FUNCTION IHlinkFrame_SetBrowseContext ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pihlbc AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING IHlinkFrame_SetBrowseContext (pthis, pihlbc) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

GetBrowseContext

FUNCTION IHlinkFrame_GetBrowseContext ( _
  BYVAL pthis AS DWORD PTR _
, BYREF ppihlbc AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING IHlinkFrame_GetBrowseContext (pthis, ppihlbc) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Navigate

FUNCTION IHlinkFrame_Navigate ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL grfHLNF AS DWORD _
, BYVAL pbc AS DWORD _
, BYVAL pibsc AS DWORD _
, BYVAL pihlNavigate AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  pwzLocation = UCODE$(pwzLocation)
  CALL DWORD @@pthis[5] USING IHlinkFrame_Navigate (pthis, grfHLNF, pbc, pibsc, pihlNavigate) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

OnNavigate

FUNCTION IHlinkFrame_OnNavigate ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL grfHLNF AS DWORD _
, BYVAL pimkTarget AS DWORD _
, BYVAL strLocation AS STRING _
, BYVAL strFriendlyName AS STRING _
, BYVAL dwreserved AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  strLocation = UCODE$(strLocation) & $NUL
  strFriendlyName = UCODE$(strFriendlyName) & $NUL
  CALL DWORD @@pthis[6] USING IHlinkFrame_OnNavigate (pthis, grfHLNF, pimkTarget, STRPTR(strLocation), strFriendlyName, dwreserved) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

UpdateHlink

FUNCTION IHlinkFrame_UpdateHlink ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL uHLID AS DWORD _
, BYVAL pimkTarget AS DWORD _
, BYVAL strLocation AS STRING _
, BYVAL strFriendlyName AS STRING _
  ) AS LONG

  LOCAL HRESULT AS LONG
  strLocation = UCODE$(strLocation) & $NUL
  strFriendlyName = UCODE$(strFriendlyName) & $NUL
  CALL DWORD @@pthis[7] USING IHlinkFrame_UpdateHlink (pthis, uHLID, pimkTarget, strLocation, strFriendlyName) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION