Поделиться через

Метод IRealTimeStylus::SetSingleTabletMode (rtscom.h)

  • Статья

Изменяет режим для объекта RealTimeStylus Class (RTS) для сбора входных данных только от одного объекта планшета, представляющего дигитайзер, подключенный к планшетному компьютеру. Входные данные пера от других дигитайзеров игнорируются RealTimeStylus.

Синтаксис

HRESULT SetSingleTabletMode(
  [in] IInkTablet *piTablet
);

Параметры

[in] piTablet

Объект интерфейса IInkTablet , представляющий устройство дигитайзера, подключенное к планшетному компьютеру.

Возвращаемое значение

Описание возвращаемых значений см. в разделе Классы и интерфейсы RealTimeStylus.

Комментарии

Для класса RealTimeStylus можно задать один из двух режимов, связанных с планшетом:

  • Режим всех планшетов (по умолчанию)
  • Режим одного планшета
Если метод IRealTimeStylus::SetAllTabletsMode () был изначально вызван и realTimeStylus включен, возвращается TPC_E_INVALID_MODE HRESULT.

Примеры

В следующем примере кода C++ объект IRealTimeStylus устанавливается в режиме одного планшета, g_pRealTimeStylusчтобы получить планшет и получить его идентификатор plug-and-play. Затем объект 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
Header rtscom.h
DLL RTSCom.dll

См. также раздел

IRealTimeStylus

Класс RealTimeStylus

Справочник по RealTimeStylus