Compartir a través de

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

  • Artículo

Modifica el modo de objeto De clase RealTimeStylus (RTS) para recopilar la entrada de un solo objeto de tableta que representa un digitalizador conectado al pc tablet. La entrada de lápiz stylus de otros digitalizadores se omite mediante RealTimeStylus.

Sintaxis

HRESULT SetSingleTabletMode(
  [in] IInkTablet *piTablet
);

Parámetros

[in] piTablet

Objeto IInkTablet Interface que representa el dispositivo digitalizador conectado al pc tablet.

Valor devuelto

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

Comentarios

Una clase RealTimeStylus se puede establecer en uno de los dos modos relacionados con la tableta:

  • Modo de todas las tabletas (valor predeterminado)
  • Modo de tableta única
Si se llamó inicialmente al método IRealTimeStylus::SetAllTabletsMode () y realTimeStylus está habilitado, se devuelve el TPC_E_INVALID_MODE HRESULT.

Ejemplos

El siguiente código de ejemplo de C++ establece un objeto IRealTimeStylus , g_pRealTimeStylus, en modo de tableta única para que pueda obtener la tableta y recuperar su identificador plug-and-play. A continuación, vuelve a establecer el objeto IRealTimeStylus en todos los modos de 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

IRealTimeStylus

Clase RealTimeStylus

Referencia de RealTimeStylus