Metode IRealTimeStylus::GetStyluses (rtscom.h)

Artikel
08/25/2023

Mengambil koleksi stylus objek Kelas RealTimeStylus yang telah ditemui.

Sintaks

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

Parameter

[out, retval] ppiInkCursors

Ketika metode ini kembali, berisi penunjuk ke koleksi stylus objek Kelas RealTimeStylus yang telah ditemui.

Mengembalikan nilai

Untuk deskripsi nilai yang dikembalikan, lihat Kelas dan Antarmuka RealTimeStylus.

Keterangan

Koleksi Kelas RealTimeStylus mencakup stylus yang konteks tabletnya telah dibuat. Koleksi tidak mencakup semua stylus yang tersedia dalam sistem dalam koleksi stylus.

Jika tidak ada objek stylus yang terdeteksi pada objek tablet yang terkait dengan objek Kelas RealTimeStylus , metode ini mengembalikan array kosong.

Metode ini tidak dapat dipanggil kecuali objek Kelas RealTimeStylus terhubung dan diaktifkan Kelas RealTimeStylus.

Catatan Metode ini dapat dipanggil jika IRealTimeStylus::Enabled Property mengembalikan false selama objek Kelas RealTimeStylus belum selesai memproses data dalam antrean. Metode ini dapat dipanggil sampai plug-in asinkron terakhir menerima Metode IStylusPlugin::RealTimeStylusDisabled.

Contoh

Kode contoh C++ berikut mendapatkan array objek Stylus yang ditemui objek Kelas RealTimeStylus sejak terakhir diaktifkan. Kemudian berulang melalui array yang melaporkan ID dari setiap stylus dalam output debug.

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

Persyaratan


Klien minimum yang didukung	Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	rtscom.h
DLL	RTSCom.dll

Lihat juga

IRealTimeStylus

Metode IRealTimeStylus::GetstylusForId

Kelas RealTimeStylus

Bagikan melalui