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

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

構文

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

パラメーター

[out, retval] ppiInkCursors

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

戻り値

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

解説

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

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

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

例

次の 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);
            }
        }
    }
}

要件

関連項目

IRealTimeStylus

IRealTimeStylus::GetStylusForId メソッド

RealTimeStylus クラス