Método IRealTimeStylus::GetAllTabletContextIds (rtscom.h)
Recupera una matriz que contiene todos los identificadores de contexto de tableta activos actualmente.
Sintaxis
HRESULT GetAllTabletContextIds(
[in, out] ULONG *pcTcidCount,
[out] TABLET_CONTEXT_ID **ppTcids
);
Parámetros
[in, out] pcTcidCount
Número de identificadores de contexto de tableta.
[out] ppTcids
Puntero a la matriz de identificadores 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
El método IRealTimeStylus::GetAllTabletContextIds proporciona acceso a todos los identificadores de contexto de tableta que están activos actualmente. Este método permite obtener estos identificadores directamente en lugar de almacenar en caché los datos de IStylusPlugin::RealTimeStylusEnabled (Método ).
El ámbito de la propiedad TabletContextID se limita a una instancia determinada de la clase RealTimeStylus; Un objeto Tablet puede tener un identificador único diferente para cada instancia de la clase RealTimeStylus.
Ejemplos
El siguiente código de ejemplo de C++ obtiene todos los identificadores de contexto de tableta y usa el primer 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
| 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 |