HTML_PAINTER enumeration

  • Article

Specifies a behavior's rendering attributes and requirements. Used in the lFlags member of the HTML_PAINTER_INFO structure, which MSHTML retrieves when it calls IHTMLPainter::GetPainterInfo.

Syntax

typedef enum _HTML_PAINTER { 
  HTMLPAINTER_OPAQUE          = 0x000001,
  HTMLPAINTER_TRANSPARENT     = 0x000002,
  HTMLPAINTER_ALPHA           = 0x000004,
  HTMLPAINTER_COMPLEX         = 0x000008,
  HTMLPAINTER_OVERLAY         = 0x000010,
  HTMLPAINTER_HITTEST         = 0x000020,
  HTMLPAINTER_SURFACE         = 0x000100,
  HTMLPAINTER_3DSURFACE       = 0x000200,
  HTMLPAINTER_NOBAND          = 0x000400,
  HTMLPAINTER_NODC            = 0x001000,
  HTMLPAINTER_NOPHYSICALCLIP  = 0x002000,
  HTMLPAINTER_NOSAVEDC        = 0x004000,
  HTMLPAINTER_SUPPORTS_XFORM  = 0x008000,
  HTMLPAINTER_EXPAND          = 0x010000,
  HTMLPAINTER_NOSCROLLBITS    = 0x020000
} HTML_PAINTER;

Constants

  • HTMLPAINTER_OPAQUE
    The behavior's rendering will be opaque; the behavior will change all pixels in its update rectangle or region and MSHTML does not need to render anything below it.

  • HTMLPAINTER_TRANSPARENT
    The behavior's rendering will be transparent; the behavior might not change all the pixels in its update rectangle or region and MSHTML needs to render content below it.

  • HTMLPAINTER_ALPHA
    Not implemented.

  • HTMLPAINTER_COMPLEX
    Not implemented.

  • HTMLPAINTER_OVERLAY
    The behavior uses DirectDraw hardware overlay planes.

  • HTMLPAINTER_HITTEST
    The behavior supports hit testing; MSHTML will call the IHTMLPainter::HitTestPoint method when relevant events fire on the element to which the behavior is attached.

  • HTMLPAINTER_SURFACE
    The behavior requires a DirectDraw surface.

  • HTMLPAINTER_3DSURFACE
    The behavior requires a Direct3D surface.

  • HTMLPAINTER_NOBAND
    Not implemented.

  • HTMLPAINTER_NODC
    No device context is required.

  • HTMLPAINTER_NOPHYSICALCLIP
    The behavior will draw entirely within its bounding area; MSHTML does not have to apply clipping.

  • HTMLPAINTER_NOSAVEDC
    The behavior will return the device context to the state in which it received it; MSHTML does not need to save the device context's state prior to passing it to the IHTMLPainter::Draw method.

  • HTMLPAINTER_SUPPORTS_XFORM
    The behavior supports transformations. If a behavior does not support transformations and MSHTML is applying a transformation to its output (for instance, in a zoomed page layout view), its IHTMLPainter::Draw method will not be called and the behavior will not be rendered.

  • HTMLPAINTER_EXPAND
    Not implemented.

  • HTMLPAINTER_NOSCROLLBITS
    Internet Explorer 6 and later. Do not use the device context to perform scroll operations. Specify this flag if the behavior has a fixed background or does not clip its text overflow.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

 Mshtml.h

IDL

 Mshtml.idl

See also

DirectX