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

Récupère un tableau contenant tous les identificateurs de contexte de tablette actuellement actifs.

Syntaxe

HRESULT GetAllTabletContextIds(
  [in, out] ULONG             *pcTcidCount,
  [out]     TABLET_CONTEXT_ID **ppTcids
);

Paramètres

[in, out] pcTcidCount

Nombre d’identificateurs de contexte de tablette.

[out] ppTcids

Pointeur vers le tableau d’identificateurs de contexte de tablette

Valeur retournée

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

Remarques

La méthode IRealTimeStylus ::GetAllTabletContextIds permet d’accéder à tous les identificateurs de contexte de tablette actuellement actifs. Cette méthode vous permet d’obtenir ces identificateurs directement au lieu de mettre en cache les données à partir des notifications de méthode IStylusPlugin ::RealTimeStylusEnabled .

L’étendue de la propriété TabletContextID est limitée à un instance donné de la classe RealTimeStylus ; un objet Tablet peut avoir un identificateur unique différent pour chaque instance de la classe RealTimeStylus.

Exemples

L’exemple de code C++ suivant obtient tous les identificateurs de contexte de tablette et utilise le premier 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);
    }
}

Configuration requise

Voir aussi

IRealTimeStylus

IRealTimeStylus ::GetTabletFromTabletContextId, méthode

Classe RealTimeStylus