HTML_PAINT_ZORDER enumeration

Indicates the order in which a behavior is to be rendered relative to the document content. Used in the lZOrder member of the HTML_PAINTER_INFO structure.

Syntax

typedef enum _HTML_PAINT_ZORDER { 
  HTMLPAINT_ZORDER_NONE                = 0,
  HTMLPAINT_ZORDER_REPLACE_ALL         = 1,
  HTMLPAINT_ZORDER_REPLACE_CONTENT     = 2,
  HTMLPAINT_ZORDER_REPLACE_BACKGROUND  = 3,
  HTMLPAINT_ZORDER_BELOW_CONTENT       = 4,
  HTMLPAINT_ZORDER_BELOW_FLOW          = 5,
  HTMLPAINT_ZORDER_ABOVE_FLOW          = 6,
  HTMLPAINT_ZORDER_ABOVE_CONTENT       = 7,
  HTMLPAINT_ZORDER_WINDOW_TOP          = 8
} HTML_PAINT_ZORDER;

Constants

• HTMLPAINT_ZORDER_NONE
  The behavior should not be rendered.

• HTMLPAINT_ZORDER_REPLACE_ALL
  The behavior replaces the element content, including the background.

• HTMLPAINT_ZORDER_REPLACE_CONTENT
  The behavior replaces the element content but not the background.

• HTMLPAINT_ZORDER_REPLACE_BACKGROUND
  The behavior replaces the element's background, but not its content.

• HTMLPAINT_ZORDER_BELOW_CONTENT
  The behavior draws after the background is drawn and before the element (along with any of its child elements) is drawn.

• HTMLPAINT_ZORDER_BELOW_FLOW
  The behavior draws after the element's child elements with a negative z-order value are rendered, but before the element itself is rendered.

• HTMLPAINT_ZORDER_ABOVE_FLOW
  The behavior draws after the element itself is rendered, but before the element's child elements with a positive z-order value are rendered.

• HTMLPAINT_ZORDER_ABOVE_CONTENT
  The behavior draws after the element and all its child elements are drawn.

• HTMLPAINT_ZORDER_WINDOW_TOP
  The behavior draws after the whole page is drawn and draws on top of all the content.

Remarks

A behavior can replace some or all of an element's content, or it can intersperse its output with an element's content at a variety of different points, as shown in the following diagram. The following diagram shows how each HTML_PAINT_ZORDER value relates to an element's content layers.

Note that if a rendering behavior specifies HTMLPAINT_ZORDER_REPLACE_ALL, other rendering behaviors attached at different points in the rendering layer will not be called to render. Similarly, if a behavior replaces content, other behaviors that intersperse their rendering with the content will not be called to render.

Requirements

Minimum supported client	Windows XP
Minimum supported server	Windows 2000 Server
Header	Mshtml.h
IDL	Mshtml.idl