RealTimeStylus.AddCustomStylusDataToQueue 方法
将自定义数据添加到 RealTimeStylus 对象的队列中。
命名空间： Microsoft.StylusInput
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）
语法
声明
Public Sub AddCustomStylusDataToQueue ( _
queue As StylusQueues, _
guid As Guid, _
data As Object _
)
用法
Dim instance As RealTimeStylus
Dim queue As StylusQueues
Dim guid As Guid
Dim data As Object
instance.AddCustomStylusDataToQueue(queue, _
guid, data)
public void AddCustomStylusDataToQueue(
StylusQueues queue,
Guid guid,
Object data
)
public:
void AddCustomStylusDataToQueue(
StylusQueues queue,
Guid guid,
Object^ data
)
public void AddCustomStylusDataToQueue(
StylusQueues queue,
Guid guid,
Object data
)
public function AddCustomStylusDataToQueue(
queue : StylusQueues,
guid : Guid,
data : Object
)
参数
- queue
类型：Microsoft.StylusInput.StylusQueues
StylusQueues 值之一，指定队列及队列中添加自定义数据的位置。
- guid
类型：System.Guid
标识所添加的自定义数据类型的全局唯一标识符 (GUID)。
- data
类型：System.Object
要添加到队列中的自定义数据。
备注
使用此方法可以通过将自定义信息添加到 RealTimeStylus 对象的队列中来扩展 RealTimeStylus 对象的功能。此类信息将作为 CustomStylusData 对象而添加。此方法通过创建自定义数据来进入和退出选择和擦除模式，是实现对 RealTimeStylus 对象进行选择和擦除的一种方法。
可以使用以下方法，将自定义手写笔数据添加到 RealTimeStylus 对象的队列 StylusQueues 的三个位置之一。
当 queue 参数设置为 Input 时，自定义数据将添加到 RealTimeStylus 对象的输入队列，并发送到同步插件集合中来自 Tablet 笔数据流的新数据之前。
- 当 queue 参数设置为 Output 时，自定义数据将添加到 RealTimeStylus 对象的输出队列中同步插件集合当前正在处理的数据之后。
当 queue 参数设置为 OutputImmediate 时，自定义数据将添加到 RealTimeStylus 对象的输出队列中同步插件集合当前正在处理的数据之前。
在以上每种情况下，同步插件集合中后面的插件所添加的数据都将添加到前面的插件所添加的数据之后。
自定义手写笔数据作为 CustomStylusData 对象添加到队列中，插件通过其 IStylusSyncPlugin.CustomStylusDataAdded 或 IStylusAsyncPlugin.CustomStylusDataAdded 方法来接收这些数据。
当不在 RealTimeStylus 对象的线程中的某个对象调用 AddCustomStylusDataToQueue 方法时，队列中自定义数据对于 RealTimeStylus 对象正在处理的数据包的关系是不确定的。
警告
将自定义数据添加到输入队列以响应实现 IStylusSyncPlugin 接口的对象接收到的自定义数据可能会在 RealTimeStylus 对象的线程中创建无限循环。
有关将数据添加到队列中的顺序的更多信息（包括图示），请参见Accessing and Manipulating Stylus Input中的概念性主题。
下面的列表描述了此方法引发异常的情况。
释放 RealTimeStylus 对象。
data 参数为 null（在 Visual Basic .NET 中为 Nothing）。
未启用 RealTimeStylus 对象。
没有相应的插件附加到 RealTimeStylus 对象以接收来自指定队列的信息。
guid 参数设置为与 DynamicRenderer 或 GestureRecognizer 类关联的 GUID。
平台
Windows Vista, Windows XP SP2, Windows Server 2003
.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。
版本信息
.NET Framework
受以下版本支持：3.0
另请参见
参考
Microsoft.StylusInput.PluginData.CustomStylusData