Método IRealTimeStylus::GetAllTabletContextIds (rtscom.h)
Recupera uma matriz que contém todos os identificadores de contexto do tablet atualmente ativos.
Sintaxe
HRESULT GetAllTabletContextIds(
[in, out] ULONG *pcTcidCount,
[out] TABLET_CONTEXT_ID **ppTcids
);
Parâmetros
[in, out] pcTcidCount
O número de identificadores de contexto do tablet.
[out] ppTcids
Ponteiro para a matriz de identificadores de contexto do tablet
Retornar valor
Para obter uma descrição dos valores retornados, consulte Classes e interfaces RealTimeStylus.
Comentários
O método IRealTimeStylus::GetAllTabletContextIds fornece acesso a todos os identificadores de contexto do tablet que estão ativos no momento. Esse método permite que você obtenha esses identificadores diretamente em vez de armazenar dados em cache de notificações do Método IStylusPlugin::RealTimeStylusEnabled .
O escopo da propriedade TabletContextID é limitado a uma determinada instância da classe RealTimeStylus; um objeto Tablet pode ter um identificador exclusivo diferente para cada instância da Classe RealTimeStylus.
Exemplos
O código de exemplo C++ a seguir obtém todos os identificadores de contexto do tablet e usa o primeiro identificador de contexto do tablet para obter um ponteiro para o 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 | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP Tablet PC Edition [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | rtscom.h |
| DLL | RTSCom.dll |