IRealTimeStylus::GetStyluses-Methode (rtscom.h)

Artikel
08/25/2023

Ruft die Auflistung von Eingabestiften ab, die das RealTimeStylus Class-Objekt gefunden hat.

Syntax

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

Parameter

[out, retval] ppiInkCursors

Wenn diese Methode zurückgibt, enthält einen Zeiger auf die Auflistung von Eingabestiften, die das RealTimeStylus Class-Objekt gefunden hat.

Rückgabewert

Eine Beschreibung der Rückgabewerte finden Sie unter RealTimeStylus-Klassen und -Schnittstellen.

Hinweise

Die RealTimeStylus-Klassenauflistung enthält die Eingabestifte, für die ein Tablet-Kontext erstellt wurde. Die Auflistung enthält nicht alle Tablettstifte, die im System in der Stiftsammlung verfügbar sind.

Wenn auf den Tablet-Objekten, die dem RealTimeStylus Class-Objekt zugeordnet sind, kein Stiftobjekt erkannt wurde, gibt diese Methode ein leeres Array zurück.

Diese Methode kann nur aufgerufen werden, wenn das RealTimeStylus-Klassenobjekt verbunden ist und die RealTimeStylus-Klasse aktiviert ist.

Hinweis Diese Methode kann aufgerufen werden, wenn die IRealTimeStylus::Enabled-Eigenschaft false zurückgibt, solange das RealTimeStylus Class-Objekt die Verarbeitung von Daten in der Warteschlange nicht abgeschlossen hat. Diese Methode kann aufgerufen werden, bis das letzte asynchrone Plug-In die IStylusPlugin::RealTimeStylusDisabled-Methode empfängt.

Beispiele

Der folgende C++-Beispielcode ruft ein Array der Stylus-Objekte ab, die das RealTimeStylus Class-Objekt seit seiner letzten Aktivierung gefunden hat. Anschließend durchläuft er das Array, das die ID jedes Eingabestifts in der Debugausgabe meldet.

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	rtscom.h
DLL	RTSCom.dll

Weitere Informationen

IRealTimeStylus

IRealTimeStylus::GetStylusForId-Methode

RealTimeStylus-Klasse

Freigeben über