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

Gets or sets the IInkRendererobject that is used to draw ink in the IInkOverlayobject.

Syntax 

[propputref] HRESULT putref_Renderer ([in] IInkRenderer *Renderer);
[propget] HRESULT get_Renderer ([out, retval] IInkRenderer 
	**Renderer
);

Parameters

Renderer

The IInkRendererobject that is used to draw ink.

This property is read/write.

Return Value

HRESULT value Description

S_OK

Success.

E_POINTER

The Rendererparameter is not a valid pointer.

E_INK_EXCEPTION

An exception occurred while processing.

Remarks

When handling certain window messages, changing the IInkRendererassociated with the IInkOverlaycan cause a reentrant function call, generating unexpected results. For example, changing to a different IInkRendereror modifying its transforms within a message handler can result in a reentrant call. This affects the following messages: WM_ACTIVATE, WM_PAINT; WM_SYSCOMMANDif wParamis set to SC_HOTKEY or SC_TASKLIST; and WM_SYSKEYDOWN(when processing Alt–Tab or Alt–Esc key combinations). It is an issue with single–threaded apartment model applications.

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