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

RealTimeStylus クラス オブジェクトが検出したスタイラスのコレクションを取得します。

構文

HRESULT GetStyluses(
  [out, retval] IInkCursors **ppiInkCursors
);

パラメーター

[out, retval] ppiInkCursors

このメソッドが戻るとき、 には RealTimeStylus クラス オブジェクトが検出したスタイラスのコレクションへのポインターが含まれます。

戻り値

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

解説

RealTimeStylus クラス コレクションには、タブレット コンテキストが作成されたスタイラスが含まれます。 コレクションには、スタイラス コレクション内のシステムで使用可能なすべてのスタイラスが含まれているわけではありません。

RealTimeStylus Class オブジェクトに関連付けられているタブレット オブジェクトでスタイラス オブジェクトが検出されていない場合、このメソッドは空の配列を返します。

RealTimeStylus クラス オブジェクトが接続され、 RealTimeStylus クラス が有効になっていない限り、このメソッド を呼び出すことはできません。

メモこのメソッドは、RealTimeStylus クラス オブジェクトがキュー内のデータの処理を完了していない限り、IRealTimeStylus::Enabled プロパティが false を返す場合に呼び出すことができます。 このメソッドは、最後の非同期プラグインが IStylusPlugin::RealTimeStylusDisabled メソッドを受け取るまで呼び出すことができます。

 

例

次の C++ コード例は、 RealTimeStylus Class オブジェクトが最後に有効になった後に検出されたスタイラス オブジェクトの配列を取得します。 次に、デバッグ出力の各スタイラスの ID を報告する配列を反復処理します。

IInkCursors *piInkCursors;

if (SUCCEEDED(g_pRealTimeStylus->GetStyluses(&piInkCursors)))
{
    long lCursorCount;
    
    if (SUCCEEDED(piInkCursors->get_Count(&lCursorCount)))
    {
        for (long l = 0; l < lCursorCount; l++)
        {
            LONG sid;
            IInkCursor *piInkCursor;
            IInkCursor *piInkCursorForId;

            piInkCursors->Item(l, &piInkCursor);
            piInkCursor->get_Id(&sid);

            if (SUCCEEDED(g_pRealTimeStylus->GetStylusForId((STYLUS_ID)sid, &piInkCursorForId)))
            {
                TRACE("Got stylus with ID %d\n", sid);
            }
        }
    }
}

要件

サポートされている最小のクライアント	Windows XP Tablet PC Edition [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	rtscom.h
[DLL]	RTSCom.dll

関連項目

IRealTimeStylus

IRealTimeStylus::GetStylusForId メソッド

RealTimeStylus クラス