Assembly: Microsoft.Ink (in microsoft.ink.dll)
public function AddCustomStylusDataToQueue ( queue : StylusQueues, guid : Guid, data : Object )
One of the StylusQueues values that specifies the queue and the location within the queue in which to add the custom data.
The globally unique identifier (GUID) that identifies the type of custom data being added.
The custom data to add to the queue.
This method enables 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. This method is one way to implement selection and erasing on your RealTimeStylus object by creating custom data for entering and exiting the selection and erasing modes.
You can add custom stylus data to the RealTimeStylus object's queues, StylusQueues, in one of three places using the.
When the queue parameter is set to Input, the custom data is added to the RealTimeStylus object's input queue and is sent to the synchronous plug-in collection before new data from the tablet pen data stream.
When the queue parameter is set to Output, the custom data is added to the RealTimeStylus object's output queue after the data currently being processed by the synchronous plug-in collection.
When the queue parameter is set to OutputImmediate, the custom data is added to the RealTimeStylus object's output queue before the data currently being processed by the synchronous plug-in collection.
In each of the previous cases, data added by subsequent plug-ins in the synchronous plug-in collection is added after data added by preceding plug-ins.
Custom stylus data is added to the queue as a CustomStylusData object and plug-ins receive this data through their IStylusSyncPlugin.CustomStylusDataAdded or IStylusAsyncPlugin.CustomStylusDataAdded method.
When an object that 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.
Adding custom data to the input queue in response to custom data received by an object which implements the IStylusSyncPlugin interface may create an infinite loop on the RealTimeStylus object's thread.
For more information about the order in which data is added to the queues, including illustrations, see the conceptual topics contained in Accessing and Manipulating Stylus Input.
The following list describes conditions under which this method throws an exception.
The RealTimeStylus object is disposed.
The data parameter is null (Nothing in Visual Basic .NET).
The RealTimeStylus object is not enabled.
No appropriate plug-ins are attached to the RealTimeStylus object to receive information from the specified queue.
Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter EditionThe Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.