IRealTimeStylus：：GetAllTabletContextIds 方法 (rtscom.h)

擷取包含所有目前使用中平板電腦內容標識碼的陣列。

語法

HRESULT GetAllTabletContextIds(
  [in, out] ULONG             *pcTcidCount,
  [out]     TABLET_CONTEXT_ID **ppTcids
);

參數

[in, out] pcTcidCount

平板電腦內容識別碼的數目。

[out] ppTcids

平板電腦內容識別碼陣列的指標

傳回值

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

備註

IRealTimeStylus：：GetAllTabletContextIds 方法方法 可讓您存取目前使用的所有平板電腦內容識別符。 這個方法可讓您直接取得這些標識符，而不是從 IStylusPlugin：：RealTimeStylusEnabled 方法 通知快取數據。

TabletContextID 屬性的範圍僅限於 RealTimeStylus 類別的指定實例;Tablet 物件可能會針對 RealTimeStylus 類別的每個實例有不同的唯一標識碼。

範例

下列 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：：GetTabletFromTabletContextId 方法

RealTimeStylus 類別