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

Récupère la propriété TabletContextId associée à un objet numériseur de tablette donné.

Syntaxe

HRESULT GetTabletContextIdFromTablet(
  [in]          IInkTablet        *piTablet,
  [out, retval] TABLET_CONTEXT_ID *ptcid
);

Paramètres

[in] piTablet

Spécifie l’objet tablette associé à un numériseur pour lequel obtenir l’identificateur unique du contexte de la tablette.

[out, retval] ptcid

Identificateur unique du contexte de la tablette.

Valeur retournée

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

Remarques

Un identificateur de contexte du numériseur est spécifique à un objet RealTimeStylus Class . Deux objets RealTimeStylus Class peuvent avoir des identificateurs de contexte différents pour le même objet numériseur. Un identificateur de contexte de tablette est valide uniquement lorsqu’un objet RealTimeStylus Class est activé. Si un objet RealTimeStylus Class est désactivé, puis réactivé, le TCID de chaque objet numériseur peut avoir une valeur différente de celle qu’il avait lors de la première activation de l’objet Classe RealTimeStylus .

Cette méthode peut être appelée même si l’objet RealTimeStylus Class n’est pas activé tant que la classe RealTimeStylus n’a pas fini de traiter les données dans la file d’attente. Cette méthode peut être appelée jusqu’à ce que le dernier plug-in asynchrone reçoive la méthode IStylusPlugin ::RealTimeStylusDisabled.

Exemples

L’exemple de code C++ suivant obtient un pointeur vers l’objet IInkTablet et l’utilise pour obtenir l’identificateur de contexte de la tablette. Il affiche ensuite les noms de toutes les tablettes attachées au système dans la fenêtre de sortie de débogage.

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

Configuration requise

Voir aussi

IRealTimeStylus

IRealTimeStylus ::GetTabletFromTabletContextId, méthode

RealTimeStylus, classe