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

Recupera un objeto IInkTablet Interface al autor de la llamada.

Sintaxis

HRESULT GetTablet(
  [out, retval] IInkTablet **ppiSingleTablet
);

Parámetros

[out, retval] ppiSingleTablet

Puntero al objeto IInkTablet Interface .

Valor devuelto

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

Comentarios

Este método devuelve, ppiSingleTablet contendrá NULL cuando RealTimeStylus reciba datos de más de esa tableta. Por ejemplo, cuando se llama al método IRealTimeStylus::SetAllTabletsMode con un valor true en una máquina con un digitalizador y un mouse.

Ejemplos

El siguiente código de ejemplo de C++ obtiene un puntero al objeto IInkTablet Interface y usa ese puntero para obtener el identificador de Plug and Play de la tableta.

// Must be in single tablet mode for GetTablet to succeed. This call to
// SetSingleTabletMode() would likely happen somewhere else in the app.
if (SUCCEEDED(g_pRealTimeStylus->SetSingleTabletMode(pInkTablet)))
{
    IInkTablet* pTablet = NULL;

    if ((SUCCEEDED(g_pRealTimeStylus->GetTablet(&pTablet))) && (NULL != pTablet))
    {
        BSTR bstrPnPID;

        if (SUCCEEDED(pTablet->get_PlugAndPlayId(&bstrPnPID)))
        {
            TRACE("The tablet's Plug-n-Play ID is: %s\n", bstrPnPID);
        }
    }

    // Restore all tablets mode.
    g_pRealTimeStylus->SetAllTabletsMode(TRUE);
}

Requisitos

Requisito	Value
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

IInkTablet (interfaz)

IRealTimeStylus

Clase RealTimeStylus