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