RealTimeStylus.AddCustomStylusDataToQueue Method
RealTimeStylus.AddCustomStylusDataToQueue Method |
Adds custom data to a queue of the RealTimeStylus object.
Definition
Visual Basic .NET Public Sub AddCustomStylusDataToQueue( _
ByVal queue As StylusQueues, _
ByVal guid As Guid, _
ByVal data As Object _
)C# public void AddCustomStylusDataToQueue(
StylusQueues queue,
Guid guid,
object data
);Managed C++ public: void AddCustomStylusDataToQueue(
StylusQueues *queue,
Guid *guid,
Object *data
);
Parameters
> > > > > > > > > > >
queue Microsoft.StylusInput.StylusQueues. The queue and the location within the queue in which to add the custom data.
Input0Specifies to add data to the input queue. When data is added to the input queue, it is automatically added to the output queue. OutputImmediate1Add data to the output queue only, before any currently-processing Sync notification. Output2Specifies to add data to the output queue only. guid System.Guid. The globally unique identifier (GUID) which identifies the type of custom data that is being added. data System.Object. The custom data to add to the queue. Exceptions
ArgumentException
:
ArgumentException
ArgumentNullExceptionnull.
COMException
Exception
InvalidOperationException
- The RealTimeStylus object is not enabled.
- No appropriate plug-ins are attached to the RealTimeStylus object to receive information from the specified queue.
- The guid parameter is set to the globally unique identifier (GUID) associated with the DynamicRenderer or the GestureRecognizer class.
InvalidOperationException
- The RealTimeStylus object is not enabled.
- No appropriate plug-ins are attached to the RealTimeStylus object to receive information from the specified queue.
- The guid parameter is set to the globally unique identifier (GUID) associated with the DynamicRenderer or the GestureRecognizer class.
ObjectDisposedException
Remarks
This method allows you to extend the functionality of the RealTimeStylus object by adding custom information to the RealTimeStylus object's queue. Such information is added as a CustomStylusData object. You could use this method to implement selection and erasing on your RealTimeStylus object by creating custom data for entering and exiting the selection and eraser modes.
The queue parameter controls how the custom information is handled by the RealTimeStylus object. The RealTimeStylus object receives information from the tablets on its input queue. It sends each data object to the objects in the collection in its SyncPluginCollection property and then places the data object on its output queue. Both queues are first in, first out (FIFO) queues.
See the following table for how the value of the queue parameter affects where the custom data is added and the custom data's relationship to the current data being processed by the IStylusSyncPlugin object's in the StylusSyncPluginCollection collection. For more information on how custom data is added to the RealTimeStylus object's queue, see Custom Stylus Data.
queue Value Description StylusQueues.OutputImmediate The custom data is added to the output queue before the current data. StylusQueues.Output The custom data is added to the output queue after the current data. StylusQueues.Input The custom data is added to the head of the input queue. When two objects in the StylusSyncPluginCollection collection add custom data to the same queue in response to the same data, then the custom data from the second synchronous plug-in is added to the queue behind the custom data from the first.
When an object which is not on the RealTimeStylus object's thread calls the AddCustomStylusDataToQueue method, the custom data's relationship on the queues to the packets that the RealTimeStylus object is processing is indeterminate.
Caution: Be careful when adding custom data to the input queue in response to custom data received by an object which implements the IStylusSyncPlugin interface, as this may create an infinite loop on the RealTimeStylus object's thread.
See Also