IRealTimeStylus：：GetTabletContextIdFromTablet 方法 (rtscom.h)

擷取與指定平板電腦數位板對象相關聯的TabletContextId屬性。

語法

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

參數

[in] piTablet

指定要取得平板電腦內容之唯一標識碼之數位板相關聯的平板計算機物件。

[out, retval] ptcid

平板電腦內容的唯一標識碼。

傳回值

如需傳回值的描述，請參閱 RealTimeStylus 類別和介面。

備註

數位板內容標識碼專屬於 RealTimeStylus Class 物件。 兩個 RealTimeStylus 類別 物件可能會有相同數位板物件的不同內容識別碼。 只有在啟用 RealTimeStylus Class 物件時，平板電腦內容識別碼才有效。 如果 已停用 RealTimeStylus Class 物件，然後重新啟用，則每個數位板物件的 TCID 值可能與第一次啟用 RealTimeStylus Class 物件時的值不同。

即使 RealTimeStylus Class 物件未啟用，只要 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
標頭	rtscom.h
Dll	RTSCom.dll

另請參閱

IRealTimeStylus

IRealTimeStylus：：GetTabletFromTabletContextId 方法

RealTimeStylus 類別