Metode IRealTimeStylus::GetTabletFromTabletContextId (rtscom.h)

Mengambil Antarmuka IInkTablet untuk konteks tablet tertentu.

Sintaks

HRESULT GetTabletFromTabletContextId(
  [in]          TABLET_CONTEXT_ID tcid,
  [out, retval] IInkTablet        **ppiTablet
);

Parameter

[in] tcid

Menentukan pengidentifikasi unik untuk konteks tablet.

[out, retval] ppiTablet

Penunjuk ke objek digitizer yang ditentukan oleh pengidentifikasi konteks tablet.

Mengembalikan nilai

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

Keterangan

Pengidentifikasi konteks tablet khusus untuk objek Kelas RealTimeStylus . Dua objek Kelas RealTimeStylus dapat memiliki pengidentifikasi konteks yang berbeda untuk objek tablet yang sama. Pengidentifikasi konteks tablet hanya valid saat objek Kelas RealTimeStylus diaktifkan. Jika objek Kelas RealTimeStylus dinonaktifkan dan kemudian diaktifkan kembali, pengidentifikasi konteks tablet untuk setiap objek tablet mungkin memiliki nilai yang berbeda dari ketika objek Kelas RealTimeStylus pertama kali diaktifkan.

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

Contoh

Kode contoh C++ berikut menggunakan pengidentifikasi konteks tablet untuk mendapatkan penunjuk ke objek Antarmuka 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);
    }
}

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::GetTabletContextIdFromTablet

Kelas RealTimeStylus