HLBWINFO structure

[HLBWINFO may be altered or unavailable in subsequent versions of the operating system or product.]

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.

Contains parameters that provide information about locations and sizes of frame-level and document-level windows within a browse context.

Syntax

typedef struct tagHLBWINFO {
  unsigned long cbSize;
  DWORD         grfHLBWIF;
  RECT          rcFramePos;
  RECT          rcDocPos;
  HLTBINFO      hltbinfo;
} HLBWINFO;

Members

• cbSize
  Value of type unsigned long that specifies the size of this structure, in bytes.

• grfHLBWIF
  Unsigned long integer value that specifies a value from the HLBWIF enumeration.

• rcFramePos
  RECT structure that contains a rectangle, in screen coordinates. If grfHLBWIF is set to HLBWIF_HASFRAMEWNDINFO, the rectangle contains the coordinates of the current frame-level windows within the browse context. When grfHLBWIF is set to HLBWIF_FRAMEWNDMAXIMIZED, frame-level windows are currently displayed maximized. In this case, rcFramePos is the "normal" size of frame-level windows—that is, the rectangle to use for any frame-level window when it is not maximized.

• rcDocPos
  RECT structure that contains a rectangle, in screen coordinates. If grfHLBWIF is set to HLBWIF_HASDOCWNDINFO, rcDocPos contains the rectangle of current document-level windows within the browse context. When grfHLBWIF is set to HLBWIF_DOCWNDMAXIMIZED, document-level windows are currently being displayed maximized. In this case, rcDocPos is the "normal" size of document-level windows—that is, the rectangle to use for any document-level window when it is not maximized.

• hltbinfo
  HLTBINFO structure that provides information about the position of the Web toolbar. This enables the target application to display its toolbar in the same ___location.

Remarks

The HLBWINFO structure is retrieved from the browse context using IHlinkBrowseContext::GetBrowseWindowInfo and put into the browse context using IHlinkBrowseContext::SetBrowseWindowInfo. Hyperlink targets retrieve the HLBWINFO structure during IHlinkTarget::Navigate to reposition their user interface properly and ensure as seamless a transition as possible to the new document or object.

Requirements