OleDraw function (ole2.h)

Enables drawing objects more easily. You can use it instead of calling IViewObject::Draw directly.

Syntax

HRESULT OleDraw(
  [in] LPUNKNOWN pUnknown,
  [in] DWORD     dwAspect,
  [in] HDC       hdcDraw,
  [in] LPCRECT   lprcBounds
);

Parameters

[in] pUnknown

Pointer to the IUnknown interface on the view object that is to be drawn.

[in] dwAspect

How the object is to be represented. Representations include content, an icon, a thumbnail, or a printed document. Possible values are taken from the DVASPECT enumeration.

[in] hdcDraw

Device context on which to draw. Cannot be a metafile device context.

[in] lprcBounds

Pointer to a RECT structure specifying the rectangle in which the object should be drawn. This parameter is converted to a RECTL structure and passed to IViewObject::Draw.

Return value

This function returns S_OK on success. Other possible values include the following.

Remarks

The OleDraw helper function calls the QueryInterface method for the object specified (pUnk), asking for an IViewObject interface on that object. Then, OleDraw converts the RECT structure to a RECTL structure, and calls IViewObject::Draw as follows:

lpViewObj->Draw(dwAspect,-1,0,0,0,hdcDraw,&rectl,0,0,0);

Do not use this function to draw into a metafile because it does not specify the parameter required for drawing into metafiles.

Requirements

See also

IViewObject::Draw