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 タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	rtscom.h
[DLL]	RTSCom.dll

こちらもご覧ください

IRealTimeStylus

IRealTimeStylus::GetTabletFromTabletContextId メソッド

RealTimeStylus クラス