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

Récupère une interface IInkTablet pour un contexte de tablette spécifié.

Syntaxe

HRESULT GetTabletFromTabletContextId(
  [in]          TABLET_CONTEXT_ID tcid,
  [out, retval] IInkTablet        **ppiTablet
);

Paramètres

[in] tcid

Spécifie l’identificateur unique pour le contexte de la tablette.

[out, retval] ppiTablet

Pointeur vers l’objet numériseur spécifié par l’identificateur de contexte de tablette.

Valeur retournée

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

Notes

Un identificateur de contexte de tablette est spécifique à un objet De classe RealTimeStylus . Deux objets de classe RealTimeStylus peuvent avoir des identificateurs de contexte différents pour le même objet tablette. Un identificateur de contexte de tablette n’est valide que lorsqu’un objet de classe RealTimeStylus est activé. Si un objet de classe RealTimeStylus est désactivé, puis réactivé, l’identificateur de contexte de tablette pour chaque objet tablette peut avoir une valeur différente de celle de l’objet classe RealTimeStylus pour la première fois.

Cette méthode peut être appelée même si la propriété IRealTimeStylus::Enabled retourne false tant que la méthode IStylusPlugin::RealTimeStylusDisabled n’a pas terminé le traitement des 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 utilise l’identificateur de contexte de tablette pour obtenir un pointeur vers l’objet IInkTablet Interface .

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

Spécifications

Voir aussi

IRealTimeStylus

IRealTimeStylus::GetTabletContextIdFromTablet, méthode

Classe RealTimeStylus