IDynamicRenderer interface

Applies to: desktop apps only

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

Members

The IDynamicRenderer interface inherits from the IUnknown interface. IDynamicRenderer also has these types of members:

Methods

The IDynamicRenderer interface has these methods.

MethodDescription
Draw

Draws the cached data to the specified device context.

Refresh

Makes the DynamicRenderer Class object refresh the data that it's currently rendering.

ReleaseCachedData

Releases specified stroke data from the temporal data held by the DynamicRenderer Class object.

 

Properties

The IDynamicRenderer interface has these properties.

PropertyAccess typeDescription

ClipRectangle

Read/write

Gets or sets the clipping rectangle for the dynamic renderer. Defaults to NULL.

Default is {0,0,0,0}. Coordinates are in pixels

ClipRegion

Read/write

Sets or gets the clipping region for the dynamic renderer. Defaults to NULL. Setting the clipping region does not trigger a redraw.

DataCacheEnabled

Read/write

Allows the caller to specify whether to use the IDynamicRenderer::ReleaseCachedData Method method.

DrawingAttributes

Read/write

Gets or sets the IDynamicRenderer::DrawingAttributes Property object used by the DynamicRenderer Class object. Allows the caller to set or modify the drawing attributes for the next stroke. Device rendering should not be using the DynamicRenderer Class object.

Enabled

Read/write

Allows the caller to turn dynamic rendering on and off. The default is false.

HWND

Read/write

Sets or gets the IDynamicRenderer::HWND Property associated with the DynamicRenderer Class object. Defaults to NULL

 

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

Minimum supported server

None supported

Header

RTSCom.h (also requires RTSCom_i.c)

DLL

RTSCom.dll

See also

RealTimeStylus Reference
GestureRecognizer Class
RealTimeStylus Classes and Interfaces

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Community Additions

ADD
Show:
© 2014 Microsoft