GetPainterInfo method

Called by MSHTML to retrieve information about the needs and functionality of a rendering behavior.

Syntax

HRESULT retVal = object.GetPainterInfo(pInfo);

Parameters

• pInfo [out]
  Type: HTML_PAINTER_INFO

  Pointer to a variable of type HTML_PAINTER_INFO that receives information the behavior needs to pass to MSHTML.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

MSHTML calls this method before it calls IHTMLPainter::Draw and after calls to IHTMLPaintSite::InvalidatePainterInfo.

When you implement this method, you must fill in the HTML_PAINTER_INFO structure to provide information to MSHTML so that it can call IHTMLPainter::Draw properly. For example, if the behavior uses a Microsoft DirectDraw object, the structure has a field where you can specify the IID for the minimum version of DirectDraw the behavior requires. MSHTML will then provide the proper DirectDraw object when it calls IHTMLPainter::Draw.