IRealTimeStylus：：GetTabletContextIdFromTablet 方法 (rtscom.h)

检索与给定平板电脑数字化器对象关联的 TabletContextId 属性。

语法

HRESULT GetTabletContextIdFromTablet(
  [in]          IInkTablet        *piTablet,
  [out, retval] TABLET_CONTEXT_ID *ptcid
);

参数

[in] piTablet

指定与数字化器关联的平板电脑对象，该数字化器要为其获取平板电脑上下文的唯一标识符。

[out, retval] ptcid

平板电脑上下文的唯一标识符。

返回值

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

注解

数字化器上下文标识符特定于 RealTimeStylus 类 对象。 对于同一数字化器对象，两个 RealTimeStylus 类 对象可能具有不同的上下文标识符。 仅当启用 RealTimeStylus 类 对象时，平板电脑上下文标识符才有效。 如果禁用并重新启用 RealTimeStylus 类 对象，则每个数字化器对象的 TCID 的值可能与首次启用 RealTimeStylus 类 对象时的值不同。

即使 RealTimeStylus 类 对象未启用，只要 RealTimeStylus 类 尚未完成队列中的数据处理，也可以调用此方法。 在最后一个异步插件收到 IStylusPlugin：：RealTimeStylusDisabled 方法之前，可以调用此方法。

示例

以下 C++ 示例代码获取指向 IInkTablet 对象的指针，并使用该指针获取平板电脑上下文标识符。 然后，它会在调试输出窗口中显示附加到系统的所有平板电脑的名称。

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 类