IInkCollector::putref_Renderer method (msinkaut.h)

Gets or sets the InkRenderer object that is used to draw ink.

This property is read/write.

Syntax

HRESULT putref_Renderer(
  IInkRenderer *NewInkRenderer
);

Parameters

NewInkRenderer

Return value

None

Remarks

When handling certain window messages, changing the Renderer associated with the InkCollector can cause a reentrant function call, generating unexpected results. For example, changing to a different Renderer or modifying its transforms within a message handler can result in a reentrant call. This affects the following messages: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND if wParam is 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

Requirement Value
Minimum supported client Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header msinkaut.h
Library InkObj.dll

See also

IInkCollector

InkCollector Class