IRealTimeStylus::GetTablet 方法 (rtscom.h)

检索调用方 IInkTablet 接口 对象。

语法

HRESULT GetTablet(
  [out, retval] IInkTablet **ppiSingleTablet
);

参数

[out, retval] ppiSingleTablet

指向 IInkTablet Interface 对象的指针。

返回值

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

注解

此方法返回,当 RealTimeStylus 从多个平板电脑接收数据时, ppiSingleTablet 将包含 NULL 。 例如,在使用数字化器和鼠标的计算机上调用值为 TRUEIRealTimeStylus::SetAllTabletsMode 方法时。

示例

以下 C++ 示例代码获取指向 IInkTablet Interface 对象的指针,并使用该指针获取平板电脑的即插即用标识符。

// Must be in single tablet mode for GetTablet to succeed. This call to
// SetSingleTabletMode() would likely happen somewhere else in the app.
if (SUCCEEDED(g_pRealTimeStylus->SetSingleTabletMode(pInkTablet)))
{
    IInkTablet* pTablet = NULL;

    if ((SUCCEEDED(g_pRealTimeStylus->GetTablet(&pTablet))) && (NULL != pTablet))
    {
        BSTR bstrPnPID;

        if (SUCCEEDED(pTablet->get_PlugAndPlayId(&bstrPnPID)))
        {
            TRACE("The tablet's Plug-n-Play ID is: %s\n", bstrPnPID);
        }
    }

    // Restore all tablets mode.
    g_pRealTimeStylus->SetAllTabletsMode(TRUE);
}

要求

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

另请参阅

IInkTablet 接口

IRealTimeStylus

RealTimeStylus 类