IRealTimeStylus：：GetTabletFromTabletCoNtextId 方法 (rtscom.h)

擷取指定平板電腦內容的 IInkTablet 介面 。

語法

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

參數

[in] tcid

指定平板電腦內容的唯一識別碼。

[out, retval] ppiTablet

平板電腦內容識別碼所指定之數位板物件的指標。

傳回值

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

備註

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

即使 IRealTimeStylus：：Enabled 屬性 傳回 false ，只要 IStylusPlugin：：RealTimeStylusDisabled 方法 尚未完成佇列中的資料處理，就可以呼叫此方法。 在最後一個非同步外掛程式收到 IStylusPlugin：：RealTimeStylusDisabled 方法之前，可以呼叫這個方法。

範例

下列 C++ 範例程式碼會使用平板電腦內容識別碼來取得 IInkTablet Interface 物件的指標。

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：：GetTabletCoNtextIdFromTablet 方法

RealTimeStylus 類別