Método IRealTimeStylus::GetTabletContextIdFromTablet (rtscom.h)
Recupera la propiedad TabletContextId asociada a un objeto digitalizador de tableta determinado.
Sintaxis
HRESULT GetTabletContextIdFromTablet(
[in] IInkTablet *piTablet,
[out, retval] TABLET_CONTEXT_ID *ptcid
);
Parámetros
[in] piTablet
Especifica el objeto de tableta asociado a un digitalizador para el que se obtiene el identificador único para el contexto de la tableta.
[out, retval] ptcid
Identificador único del contexto de la 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 del digitalizador es específico de un objeto RealTimeStylus Class . Dos objetos De clase RealTimeStylus pueden tener identificadores de contexto diferentes para el mismo objeto de digitalizador. Un identificador de contexto de tableta solo es válido mientras se habilita un objeto RealTimeStylus Class . Si un objeto Clase RealTimeStylus está deshabilitado y, a continuación, se vuelve a habilitar, el TCID para cada objeto de digitalizador podría tener un valor diferente al que tenía cuando el objeto Clase RealTimeStylus se habilitó por primera vez.
Se puede llamar a este método incluso si el objeto Clase RealTimeStylus no está habilitado siempre que la clase RealTimeStylus no haya terminado de procesar los 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++ obtiene un puntero al objeto IInkTablet y lo usa para obtener el identificador de contexto de la tableta. A continuación, muestra los nombres de todas las tabletas conectadas al sistema en la ventana de salida de depuración.
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
| 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 |