IRealTimeStylus::Metode GetTablet (rtscom.h)

Mengambil objek Antarmuka IInkTablet ke pemanggil.

Sintaks

HRESULT GetTablet(
  [out, retval] IInkTablet **ppiSingleTablet
);

Parameter

[out, retval] ppiSingleTablet

Penunjuk ke objek Antarmuka IInkTablet .

Nilai kembali

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

Keterangan

Metode ini mengembalikan, ppiSingleTablet akan berisi NULL ketika RealTimeStylus menerima data dari lebih dari satu tablet tersebut. Misalnya, ketika Metode IRealTimeStylus::SetAllTabletsMode dipanggil dengan nilai TRUE pada komputer dengan digitizer dan mouse.

Contoh

Kode contoh C++ berikut mendapatkan penunjuk ke objek Antarmuka IInkTablet dan menggunakan penunjuk tersebut untuk mendapatkan pengidentifikasi Plug and Play tablet.

// Must be in single tablet mode for GetTablet to succeed. This call to
// SetSingleTabletMode() would likely happen somewhere else in the app.
if (SUCCEEDED(g_pRealTimeStylus->SetSingleTabletMode(pInkTablet)))
{
    IInkTablet* pTablet = NULL;

    if ((SUCCEEDED(g_pRealTimeStylus->GetTablet(&pTablet))) && (NULL != pTablet))
    {
        BSTR bstrPnPID;

        if (SUCCEEDED(pTablet->get_PlugAndPlayId(&bstrPnPID)))
        {
            TRACE("The tablet's Plug-n-Play ID is: %s\n", bstrPnPID);
        }
    }

    // Restore all tablets mode.
    g_pRealTimeStylus->SetAllTabletsMode(TRUE);
}

Persyaratan

Persyaratan Nilai
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

Antarmuka IInkTablet

IRealTimeStylus

Kelas RealTimeStylus