Provides access to the stylus events coming from pen or touch digitizers.
In This Section
This object implements the IRealTimeStylus COM interface.
This object can be instantiated by calling the CoCreateInstance method in C++.
You can fully control, dynamically render, modify, and even delete data from the packet stream within the synchronous and asynchronous plug-ins of the RealTimeStylus Class object.
The real time stylus provides a way to create an InkCollecting object that is single-threaded and resident in the application UI thread. This InkCollecting object accesses the real time stylus data from the queue. An InkCollecting object in conjunction with real time stylus enables real-time selection editing and real-time editing of the collected ink data. For more information, please see Accessing and Manipulating Stylus Input.
Use the RealTimeStylus Class object to interact directly with the tablet stylus data stream or to block real-time inking. Use the InkCollector Class object, InkOverlay Class object, InkPicture Control control, or InkEdit Control control when the default behavior of these objects provides the behavior you need.
The real time stylus events are on a specific window handle within a specific window input rectangle. The RealTimeStylusService can send stylus data to multiple RealTimeStylus Class objects. Each RealTimeStylus Class object receives stylus data for a specific section of a window based on the defined IRealTimeStylus::WindowInputRectangle Property for that RealTimeStylus Class object. The RealTimeStylus Class object gets the stylus data and then processes this through a list of synchronous and asynchronous plug-ins.
The difference between the synchronous plug-ins and the asynchronous plug-ins lies in the thread in which they execute and the calling sequence. Synchronous plug-ins are called by the thread in which the RealTimeStylus Class object executes. Every time RealTimeStylus Class object is instantiated, an execution thread is instantiated. Synchronous plug-ins are executed on this new thread instantiated for the instance of the RealTimeStylus Class object. Asynchronous plug-ins are called through the UI or application thread after the packet stream has been processed by the synchronous plug-ins and stored in the output queue.