通过

IRealTimeStylus：：SetSingleTabletMode 方法 (rtscom.h)

  • 项目

修改 RealTimeStylus 类 (RTS) 对象的模式，以仅从一个表示连接到平板电脑的数字化器的平板电脑对象收集输入。 RealTimeStylus 忽略来自其他数字化器的触笔输入。

语法

HRESULT SetSingleTabletMode(
  [in] IInkTablet *piTablet
);

参数

[in] piTablet

IInkTablet Interface 对象，该对象表示连接到平板电脑的数字化器设备。

返回值

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

注解

RealTimeStylus 类可以设置为两种与平板电脑相关的模式之一：

  • 所有平板电脑模式 (默认)
  • 单平板电脑模式
如果最初调用 了 IRealTimeStylus：：SetAllTabletsMode 方法 () 并且启用了 RealTimeStylus，则返回TPC_E_INVALID_MODE HRESULT。

示例

下面的 C++ 示例代码将 IRealTimeStylus 对象 g_pRealTimeStylus设置为单平板电脑模式，以便它可以获取平板电脑并检索其即插即用标识符。 然后，它将 IRealTimeStylus 对象设置回所有平板电脑模式。

// 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

另请参阅

IRealTimeStylus

RealTimeStylus 类

RealTimeStylus 参考