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

Статья
08/25/2023

Извлекает свойство 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
Header	rtscom.h
DLL	RTSCom.dll

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

IRealTimeStylus

Метод IRealTimeStylus::GetTabletFromTabletContextId

Класс RealTimeStylus

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