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

Статья
03/05/2024

Извлекает объект интерфейса IInkTablet для вызывающего объекта.

Синтаксис

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

Параметры

[out, retval] ppiSingleTablet

Указатель на объект интерфейса IInkTablet .

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

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

Этот метод возвращает , ppiSingleTablet будет содержать ЗНАЧЕНИЕ NULL , когда RealTimeStylus получает данные от нескольких планшетов. Например, если метод IRealTimeStylus::SetAllTabletsMode вызывается со значением TRUE на компьютере с дигитайзером и мышью.

Примеры

Следующий пример кода C++ получает указатель на объект интерфейса IInkTablet и использует этот указатель для получения идентификатора Plug and Play планшета.

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

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

Интерфейс IInkTablet

IRealTimeStylus

Класс RealTimeStylus

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