IRealTimeStylus::GetTabletFromTabletContextId メソッド (rtscom.h)

指定したタブレット コンテキストの IInkTablet インターフェイス を取得します。

構文

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

パラメーター

[in] tcid

タブレット コンテキストの一意識別子を指定します。

[out, retval] ppiTablet

タブレット コンテキスト識別子で指定されたデジタイザー オブジェクトへのポインター。

戻り値

戻り値の詳細については、「 RealTimeStylus クラスとインターフェイス」を参照してください。

解説

タブレット コンテキスト識別子は、 RealTimeStylus クラス オブジェクトに固有です。 2 つの RealTimeStylus クラス オブジェクトは、同じタブレット オブジェクトに対して異なるコンテキスト識別子を持つことができます。 タブレット コンテキスト識別子は、 RealTimeStylus クラス オブジェクトが有効になっている間のみ有効です。 RealTimeStylus クラス オブジェクトを無効にしてから再度有効にすると、各タブレット オブジェクトのタブレット コンテキスト識別子の値が RealTimeStylus クラス オブジェクトが最初に有効になったときとは異なる場合があります。

IStylusPlugin::RealTimeStylusDisabled メソッドがキュー内のデータの処理を完了していない限り、IRealTimeStylus::Enabled プロパティが false を返した場合でも、このメソッドを呼び出すことができます。 このメソッドは、最後の非同期プラグインが 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);
    }
}

要件

関連項目

IRealTimeStylus

IRealTimeStylus::GetTabletContextIdFromTablet メソッド

RealTimeStylus クラス