IRealTimeStylus::GetStyluses 方法 (rtscom.h)
检索 RealTimeStylus 类 对象遇到的触笔集合。
语法
HRESULT GetStyluses(
[out, retval] IInkCursors **ppiInkCursors
);
parameters
[out, retval] ppiInkCursors
此方法返回时,包含指向 RealTimeStylus 类 对象遇到的触笔集合的指针。
返回值
有关返回值的说明,请参阅 RealTimeStylus 类和接口。
注解
RealTimeStylus 类集合包括为其创建了平板电脑上下文的触笔。 集合不包括触笔集合中系统中可用的所有触笔。
如果在与 RealTimeStylus 类 对象关联的平板电脑对象上未检测到触笔对象,则此方法返回空数组。
除非连接 了 RealTimeStylus 类 对象并启用了 RealTimeStylus 类,否则无法调用此方法。
注意 如果 IRealTimeStylus::Enabled 属性 返回 false,只要 RealTimeStylus 类 对象尚未完成队列中的数据处理,则可以调用此方法。 在最后一个异步插件收到 IStylusPlugin::RealTimeStylusDisabled 方法之前,可以调用此方法。
示例
以下 C++ 示例代码获取 RealTimeStylus 类 对象自上次启用以来遇到的 Stylus 对象的数组。 然后,它会循环访问报告调试输出中每个触笔的 ID 的数组。
IInkCursors *piInkCursors;
if (SUCCEEDED(g_pRealTimeStylus->GetStyluses(&piInkCursors)))
{
long lCursorCount;
if (SUCCEEDED(piInkCursors->get_Count(&lCursorCount)))
{
for (long l = 0; l < lCursorCount; l++)
{
LONG sid;
IInkCursor *piInkCursor;
IInkCursor *piInkCursorForId;
piInkCursors->Item(l, &piInkCursor);
piInkCursor->get_Id(&sid);
if (SUCCEEDED(g_pRealTimeStylus->GetStylusForId((STYLUS_ID)sid, &piInkCursorForId)))
{
TRACE("Got stylus with ID %d\n", sid);
}
}
}
}
要求
最低受支持的客户端 | Windows XP Tablet PC Edition [仅限桌面应用] |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | rtscom.h |
DLL | RTSCom.dll |
请参阅
IRealTimeStylus::GetStylusForId 方法
RealTimeStylus 类