IRealTimeStylus::GetTabletContextIdFromTablet メソッド (rtscom.h)
特定のタブレット デジタイザー オブジェクトに関連付けられている TabletContextId プロパティを取得します。
構文
HRESULT GetTabletContextIdFromTablet(
[in] IInkTablet *piTablet,
[out, retval] TABLET_CONTEXT_ID *ptcid
);
パラメーター
[in] piTablet
タブレット コンテキストの一意識別子を取得するデジタイザーに関連付けられているタブレット オブジェクトを指定します。
[out, retval] ptcid
タブレット コンテキストの一意識別子。
戻り値
戻り値の説明については、「 RealTimeStylus クラスとインターフェイス」を参照してください。
注釈
デジタイザー コンテキスト識別子は、 RealTimeStylus クラス オブジェクトに固有です。 2 つの RealTimeStylus クラス オブジェクトは、同じデジタイザー オブジェクトに対して異なるコンテキスト識別子を持つことができます。 タブレット コンテキスト識別子は、 RealTimeStylus クラス オブジェクトが有効になっている間のみ有効です。 RealTimeStylus クラス オブジェクトを無効にしてから再度有効にすると、各デジタイザー オブジェクトの TCID の値が RealTimeStylus クラス オブジェクトが最初に有効になったときとは異なる場合があります。
RealTimeStylus クラスがキュー内のデータの処理を完了していない限り、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 タブレット PC エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | rtscom.h |
| [DLL] | RTSCom.dll |