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

Recupera una interfaz IInkTablet para un contexto de tableta especificado.

Sintaxis

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

Parámetros

[in] tcid

Especifica el identificador único para el contexto de la tableta.

[out, retval] ppiTablet

Puntero al objeto de digitalizador especificado por el identificador de contexto de tableta.

Valor devuelto

Para obtener una descripción de los valores devueltos, vea RealTimeStylus Classes and Interfaces (Clases e interfaces de RealTimeStylus).

Comentarios

Un identificador de contexto de tableta es específico de un objeto RealTimeStylus Class . Dos objetos De clase RealTimeStylus pueden tener identificadores de contexto diferentes para el mismo objeto de tableta. Un identificador de contexto de tableta solo es válido mientras un objeto Clase RealTimeStylus está habilitado. Si un objeto Clase RealTimeStylus está deshabilitado y, a continuación, se vuelve a habilitar, el identificador de contexto de la tableta para cada objeto de tableta puede tener un valor diferente al que se habilitó por primera vez el objeto Clase RealTimeStylus .

Se puede llamar a este método incluso si la propiedad IRealTimeStylus::Enabled devuelve false siempre que el método IStylusPlugin::RealTimeStylusDisabled no haya terminado de procesar datos en la cola. Se puede llamar a este método hasta que el último complemento asincrónico recibe IStylusPlugin::RealTimeStylusDisabled (Método).

Ejemplos

El siguiente código de ejemplo de C++ usa el identificador de contexto de tableta para obtener un puntero al objeto 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);
    }
}

Requisitos

Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	rtscom.h
Archivo DLL	RTSCom.dll

Consulte también

IRealTimeStylus

IRealTimeStylus::GetTabletContextIdFromTablet (Método)

RealTimeStylus (clase)