Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The IInkRenderermethod that draws the IInkStrokeDispobject using the known device context, and optionally draws the IInkStrokeDispobject with the known IInkDrawingAttributesobject.

Syntax

HRESULT DrawStroke (
  [in] long hdc,
  [in] IInkStrokeDisp *stroke,
  [in,optional,defaultvalue(0)] IInkDrawingAttributes 
	*drawingAttributes
);

Parameters

hdc

Specifies the handle of the device context on which to draw.

stroke

Specifies the stroke to draw.

drawingAttributes

Specifies the IInkDrawingAttributesto use on the drawing. The default value is NULL. If IInkDrawingAttributesis specified, they override the IInkStrokeDisp::DrawingAttributes.

Return Value

HRESULT value Description

S_OK

Success.

E_POINTER

A parameter contained an invalid pointer.

E_INK_MISMATCHED_INK_OBJECT

The strokes parameter is associated with a different IInkDispobject.

E_INVALIDARG

Invalid display handle.

E_INK_INCOMPATIBLE_OBJECT

The strokeor the drawingAttributesparameter does not point to a valid object.

E_INK_EXCEPTION

An exception occurred inside the method.

E_UNEXPECTED

Unexpected parameter or property type.

Remarks

The pen width is multiplied (or scaled) by the square root of the determinant of the view transform.

Note:
If you have not set the pen width explicitly, it is 53 by default. You must multiply the pen width by the square root of the determinant to yield the correct bounding box. The height and width of the bounding box are expanded by half this amount in each direction.

For example, consider that the pen width is 53, the square root of the determinant is 50, and the bounding box is (0,0,1000,1000). The pen width adjustment to the bounding box in each direction is calculated as (53*50)/2, and the right and bottom sides are incremented by one. This results in a rendered bounding box of (-1325,-1325,2326,2326).

The IInkRendererforces the viewport and window origins to 0, 0. Any existing settings are saved and restored, but are not used by the IInkRenderer. To perform scrolling, use the IInkRendererobject's view and object transform methods.

Requirements

Header msinkaut.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later

See Also