See Also
 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. |
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 |