IRealTimeStylus：：GetAllTabletContextIds 方法 (rtscom.h)

检索包含当前所有活动平板电脑上下文标识符的数组。

语法

HRESULT GetAllTabletContextIds(
  [in, out] ULONG             *pcTcidCount,
  [out]     TABLET_CONTEXT_ID **ppTcids
);

参数

[in, out] pcTcidCount

平板电脑上下文标识符的数目。

[out] ppTcids

指向平板电脑上下文标识符数组的指针

返回值

有关返回值的说明，请参阅 RealTimeStylus 类和接口。

注解

IRealTimeStylus：：GetAllTabletContextIds 方法 方法提供对当前处于活动状态的所有平板电脑上下文标识符的访问权限。 使用此方法可以直接获取这些标识符，而不是缓存 来自 IStylusPlugin：：RealTimeStylusEnabled 方法 通知的数据。

TabletContextID 属性的范围仅限于 RealTimeStylus 类的给定实例;对于 RealTimeStylus 类的每个实例，Tablet 对象可能具有不同的唯一标识符。

示例

以下 C++ 示例代码获取所有平板电脑上下文标识符，并使用第一个平板电脑上下文标识符获取指向 IInkTablet Interface 对象的指针。

TABLET_CONTEXT_ID* pTcids = NULL;
TABLET_CONTEXT_ID tcid = 0;
ULONG ulTcidCount = 0;
IInkTablet* pInkTablet = NULL;

if (SUCCEEDED(g_pRealTimeStylus->GetAllTabletContextIds(&ulTcidCount, &pTcids)))
{
    TRACE("Got the tablet context ID array.\n");

    // Loop through all the tablets on the system
    for (ULONG i = 0; i < ulTcidCount; i++)
    {
        // Get the tablet from the context ID
        if (SUCCEEDED(g_pRealTimeStylus->GetTabletFromTabletContextId(pTcids[i], &pInkTablet)))
        {
            // Display the name of the tablet in debug output
            BSTR bstrName;
            if (SUCCEEDED(pInkTablet->get_Name(&bstrName)))
            {
                TRACE("The name of tablet %d is %s.\n", i, bstrName);
            }
        }
    }

    // Get the context ID from the tablet
    if (SUCCEEDED(g_pRealTimeStylus->GetTabletContextIdFromTablet(pInkTablet, &tcid)))
    {
        TRACE("The context ID of the tablet is %d\n", tcid);
    }
}

要求

要求	值
最低受支持的客户端	Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	rtscom.h
DLL	RTSCom.dll

另请参阅

IRealTimeStylus

IRealTimeStylus：：GetTabletFromTabletContextId 方法

RealTimeStylus 类