Compartilhar via


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

Confira também

IRealTimeStylus

Método IRealTimeStylus::GetTabletFromTabletContextId

Classe RealTimeStylus