Metodo IRealTimeStylus::GetTabletContextIdFromTablet (rtscom.h)

Articolo
03/01/2024

Recupera la proprietà TabletContextId associata a un oggetto digitalizzatore tablet specificato.

Sintassi

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

Parametri

[in] piTablet

Specifica l'oggetto tablet associato a un digitalizzatore per il quale ottenere l'identificatore univoco per il contesto del tablet.

[out, retval] ptcid

Identificatore univoco per il contesto del tablet.

Valore restituito

Per una descrizione dei valori restituiti, vedere Classi e interfacce RealTimeStylus.

Commenti

Un identificatore di contesto del digitalizzatore è specifico di un oggetto Classe RealTimeStylus . Due oggetti Classe RealTimeStylus possono avere identificatori di contesto diversi per lo stesso oggetto digitalizzatore. Un identificatore di contesto del tablet è valido solo quando è abilitato un oggetto Classe RealTimeStylus . Se un oggetto RealTimeStylus Class è disabilitato e quindi riabilitato, il TCID per ogni oggetto digitalizzatore potrebbe avere un valore diverso rispetto a quello di quando l'oggetto Classe RealTimeStylus è stato abilitato per la prima volta.

Questo metodo può essere chiamato anche se l'oggetto Classe RealTimeStylus non è abilitato purché la classe RealTimeStylus non abbia completato l'elaborazione dei dati nella coda. Questo metodo può essere chiamato finché l'ultimo plug-in asincrono non riceve il metodo IStylusPlugin::RealTimeStylusDisabled.

Esempio

Il codice di esempio C++ seguente ottiene un puntatore all'oggetto IInkTablet e lo usa per ottenere l'identificatore del contesto del tablet. Visualizza quindi i nomi di tutti i tablet collegati al sistema nella finestra di output di debug.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	rtscom.h
DLL	RTSCom.dll

Vedi anche

IRealTimeStylus

Metodo IRealTimeStylus::GetTabletFromTabletContextId

Classe RealTimeStylus

Condividi tramite