IRealTimeStylus::GetTabletContextIdFromTablet 메서드(rtscom.h)

지정된 태블릿 디지타이저 개체와 연결된 TabletContextId 속성을 검색합니다.

구문

HRESULT GetTabletContextIdFromTablet(
  [in]          IInkTablet        *piTablet,
  [out, retval] TABLET_CONTEXT_ID *ptcid
);

매개 변수

[in] piTablet

태블릿 컨텍스트에 대한 고유 식별자를 가져올 디지타이저와 연결된 태블릿 개체를 지정합니다.

[out, retval] ptcid

태블릿 컨텍스트의 고유 식별자입니다.

반환 값

반환 값에 대한 설명은 RealTimeStylus 클래스 및 인터페이스를 참조하세요.

설명

디지타이저 컨텍스트 식별자는 RealTimeStylus 클래스 개체와 관련이 있습니다. 두 RealTimeStylus 클래스 개체는 동일한 디지타이저 개체에 대해 서로 다른 컨텍스트 식별자를 가질 수 있습니다. 태블릿 컨텍스트 식별자는 RealTimeStylus 클래스 개체를 사용하는 동안에만 유효합니다. RealTimeStylus Class 개체를 사용하지 않도록 설정한 다음 다시 사용하도록 설정하면 각 디지타이저 개체의 TCID 값이 RealTimeStylus Class 개체를 처음 사용하도록 설정했을 때와 다른 값을 가질 수 있습니다.

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 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	rtscom.h
DLL	RTSCom.dll

추가 정보

IRealTimeStylus

IRealTimeStylus::GetTabletFromTabletContextId 메서드

RealTimeStylus 클래스