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

Статья
08/25/2023

Извлекает интерфейс IInkTablet для указанного контекста планшета.

Синтаксис

HRESULT GetTabletFromTabletContextId(
  [in]          TABLET_CONTEXT_ID tcid,
  [out, retval] IInkTablet        **ppiTablet
);

Параметры

[in] tcid

Задает уникальный идентификатор для контекста планшета.

[out, retval] ppiTablet

Указатель на объект дигитайзера, заданный идентификатором контекста планшета.

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

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

Идентификатор контекста планшета зависит от объекта Класса RealTimeStylus . Два объекта Класса RealTimeStylus могут иметь разные идентификаторы контекста для одного и того же объекта планшета. Идентификатор контекста планшета действителен только при включенном объекте Класса RealTimeStylus . Если объект Класса RealTimeStylus отключен, а затем снова включен, идентификатор контекста планшета для каждого объекта планшета может иметь значение, отличное от значения, когда объект Класса RealTimeStylus был впервые включен.

Этот метод можно вызывать, даже если свойство IRealTimeStylus::Enabled возвращает значение false , если метод IStylusPlugin::RealTimeStylusDisabled не завершил обработку данных в очереди. Этот метод можно вызывать до тех пор, пока последний асинхронный подключаемый модуль не получит метод 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::GetTabletContextIdFromTablet

Класс RealTimeStylus

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