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

IRealTimeStylus::GetStylusForId 方法

RealTimeStylus 类