Metodo IRealTimeStylus::GetTablet (rtscom.h)

Articolo
03/01/2024

Recupera un oggetto IInkTablet Interface al chiamante.

Sintassi

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

Parametri

[out, retval] ppiSingleTablet

Puntatore all'oggetto IInkTablet Interface .

Valore restituito

Per una descrizione dei valori restituiti, vedere Classi e interfacce RealTimeStylus.

Commenti

Questo metodo restituisce, ppiSingleTablet conterrà NULL quando RealTimeStylus riceve dati da più tablet. Ad esempio, quando il metodo IRealTimeStylus::SetAllTabletsMode viene chiamato con un valore TRUE in un computer con un digitalizzatore e un mouse.

Esempio

Il codice di esempio C++ seguente ottiene un puntatore all'oggetto Interfaccia IInkTablet e usa tale puntatore per ottenere l'identificatore di Plug and Play del 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);
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	rtscom.h
DLL	RTSCom.dll

Vedi anche

Interfaccia IInkTablet

IRealTimeStylus

Classe RealTimeStylus

Condividi tramite