Méthode IRealTimeStylus ::GetTablet (rtscom.h)

  • Article

Récupère un objet IInkTablet Interface à l’appelant.

Syntaxe

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

Paramètres

[out, retval] ppiSingleTablet

Pointeur vers l’objet IInkTablet Interface .

Valeur retournée

Pour obtenir une description des valeurs renvoyées, consultez Classes et interfaces RealTimeStylus.

Remarques

Cette méthode retourne, ppiSingleTablet contient la valeur NULL lorsque realTimeStylus reçoit des données de plusieurs tablettes. Par instance, lorsque la méthode IRealTimeStylus ::SetAllTabletsMode est appelée avec la valeur TRUE sur un ordinateur doté d’un numériseur et d’une souris.

Exemples

L’exemple de code C++ suivant obtient un pointeur vers l’objet IInkTablet Interface et utilise ce pointeur pour obtenir l’identificateur Plug-and-Play de la tablette.

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP Édition Tablette PC [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête rtscom.h
DLL RTSCom.dll

Voir aussi

IInkTablet, interface

IRealTimeStylus

RealTimeStylus, classe