Partager via


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

Modifie le mode de l’objet RTS (RealTimeStylus Class ) pour collecter les entrées d’un seul objet de tablette représentant un numériseur attaché au Tablet PC. L’entrée de stylet d’autres numériseurs est ignorée par realTimeStylus.

Syntaxe

HRESULT SetSingleTabletMode(
  [in] IInkTablet *piTablet
);

Paramètres

[in] piTablet

Objet IInkTablet Interface qui représente l’appareil du numériseur attaché au Tablet PC.

Valeur retournée

Pour obtenir une description des valeurs de retour, consultez Classes et interfaces RealTimeStylus.

Remarques

Une classe RealTimeStylus peut être définie sur l’un des deux modes liés aux tablettes :

  • Mode Toutes les tablettes (par défaut)
  • Mode tablette unique
Si la méthode IRealTimeStylus ::SetAllTabletsMode () a été initialement appelée et que realTimeStylus est activée, le TPC_E_INVALID_MODE HRESULT est retourné.

Exemples

L’exemple de code C++ suivant définit un objet IRealTimeStylus , g_pRealTimeStylus, en mode tablette unique afin qu’il puisse obtenir la tablette et récupérer son identificateur plug-and-play. Ensuite, il rétablit le mode toutes les tablettes de l’objet IRealTimeStylus .

// 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 Tablet 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

IRealTimeStylus

Classe RealTimeStylus

Référence RealTimeStylus