IRealTimeStylus::GetTabletContextIdFromTablet-Methode (rtscom.h)

Ruft die TabletContextId-Eigenschaft ab, die einem bestimmten Tablet-Digitizer-Objekt zugeordnet ist.

Syntax

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

Parameter

[in] piTablet

Gibt das Einem Digitizer zugeordnete Tablet-Objekt an, für das der eindeutige Bezeichner für den Tablet-Kontext abgerufen werden soll.

[out, retval] ptcid

Der eindeutige Bezeichner für den Tablet-Kontext.

Rückgabewert

Eine Beschreibung der Rückgabewerte finden Sie unter RealTimeStylus-Klassen und -Schnittstellen.

Hinweise

Ein Digitizer-Kontextbezeichner ist spezifisch für ein RealTimeStylus-Klassenobjekt . Zwei RealTimeStylus-Klassenobjekte verfügen möglicherweise über unterschiedliche Kontextbezeichner für dasselbe Digitizerobjekt. Ein Tablet-Kontextbezeichner ist nur gültig, wenn ein RealTimeStylus-Klassenobjekt aktiviert ist. Wenn ein RealTimeStylus Class-Objekt deaktiviert und dann wieder aktiviert wird, hat die TCID für jedes Digitizerobjekt möglicherweise einen anderen Wert als bei der ersten Aktivierung des RealTimeStylus-Klassenobjekts .

Diese Methode kann auch dann aufgerufen werden, wenn das RealTimeStylus Class-Objekt nicht aktiviert ist, solange die Verarbeitung der Daten in der Warteschlange von der RealTimeStylus-Klasse nicht abgeschlossen ist. Diese Methode kann aufgerufen werden, bis das letzte asynchrone Plug-In die IStylusPlugin::RealTimeStylusDisabled-Methode empfängt.

Beispiele

Der folgende C++-Beispielcode ruft einen Zeiger auf das IInkTablet-Objekt ab und verwendet diesen, um den Tablet-Kontextbezeichner abzurufen. Anschließend werden die Namen aller An das System angefügten Tablets im Debugausgabefenster angezeigt.

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

Anforderungen

Weitere Informationen

IRealTimeStylus

IRealTimeStylus::GetTabletFromTabletContextId-Methode

RealTimeStylus-Klasse