IDynamicRenderer interface

Displays the tablet pen data in real-time as that data is being handled by the RealTimeStylus Class object.

Methods

The IDynamicRenderer interface has these methods.

Method Description
IDynamicRenderer::Draw Draws the cached data to the specified device context.
IDynamicRenderer::get_ClipRectangle Gets or sets the clipping rectangle for the DynamicRenderer Class object.
IDynamicRenderer::get_ClipRegion Gets or sets the clipping region for the DynamicRenderer Class object.
IDynamicRenderer::get_DataCacheEnabled Gets or sets a value that indicates whether data caching is enabled for the DynamicRenderer Class object.
IDynamicRenderer::get_DrawingAttributes Gets or sets the DrawingAttributes object used by the DynamicRenderer Class object.
IDynamicRenderer::get_Enabled Gets or sets a value that turns dynamic rendering on and off.
IDynamicRenderer::get_HWND Gets or sets the window handle, HWND, associated with the DynamicRenderer Class object.
IDynamicRenderer::put_ClipRectangle Gets or sets the clipping rectangle for the DynamicRenderer Class object.
IDynamicRenderer::put_ClipRegion Gets or sets the clipping region for the DynamicRenderer Class object.
IDynamicRenderer::put_DataCacheEnabled Gets or sets a value that indicates whether data caching is enabled for the DynamicRenderer Class object.
IDynamicRenderer::put_Enabled Gets or sets a value that turns dynamic rendering on and off.
IDynamicRenderer::put_HWND Gets or sets the window handle, HWND, associated with the DynamicRenderer Class object.
IDynamicRenderer::Refresh Causes the DynamicRenderer Class object to redraw the ink data that is currently rendering.
IDynamicRenderer::ReleaseCachedData Releases specified stroke data from the temporal data held by DynamicRenderer Class.

Remarks

This interface is implemented by the DynamicRenderer Class.

The DynamicRenderer Class renders packet data dynamically.

Be sure the set the handle of the DynamicRenderer Class before you add it to a plug-in collection on the RealTimeStylus Class. If the handle is not set, the IStylusPlugin::Error Method notification method on each plug-in is called. For more information see Error Handling Considerations for the StylusInput APIs.

The DynamicRenderer Class implements the IStylusSyncPlugin interface.

A DynamicRenderer Class object can redraw the ink when a window has been invalidated.

While it is possible to have a given plug-in associated with multiple RealTimeStylus Class objects, the DynamicRenderer Class and GestureRecognizer Class plug-ins are not designed to support this.

Note  Calling interface members directly without the intervention of a RealTimeStylus Class instance is not supported.
 
The DynamicRenderer Class has two categories of properties: those for which changes take effect immediately and those for which changes take effect upon the next IStylusPlugin::StylusDown Method event notification. The IDynamicRenderer::ClipRectangle Property property takes effect immediately, enabling the text input area to grow dynamically as the user writes. The other properties take effect after the next IStylusPlugin::StylusDown Method event notification.

The following are the properties for which changes take immediate effect:

IDynamicRenderer::ClipRectangle Property

The following are the properties for which changes do not take immediate effect and are delayed:

IDynamicRenderer::DataCacheEnabled Property

IDynamicRenderer::DrawingAttributes Property

Requirements

   
Minimum supported client Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header rtscom.h

See Also

GestureRecognizer Class

RealTimeStylus Classes and Interfaces

RealTimeStylus Reference