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

Recupera a propriedade TabletContextId associada a um determinado objeto digitalizador de tablet.

Sintaxe

HRESULT GetTabletContextIdFromTablet(
  [in]          IInkTablet        *piTablet,
  [out, retval] TABLET_CONTEXT_ID *ptcid
);

Parâmetros

[in] piTablet

Especifica o objeto tablet associado a um digitalizador para o qual obter o identificador exclusivo para o contexto do tablet.

[out, retval] ptcid

O identificador exclusivo para o contexto do tablet.

Retornar valor

Para obter uma descrição dos valores retornados, consulte Classes e interfaces RealTimeStylus.

Comentários

Um identificador de contexto do digitalizador é específico para um objeto Classe RealTimeStylus . Dois objetos da classe RealTimeStylus podem ter identificadores de contexto diferentes para o mesmo objeto digitalizador. Um identificador de contexto de tablet é válido somente enquanto um objeto Classe RealTimeStylus está habilitado. Se um objeto RealTimeStylus Class estiver desabilitado e habilitado novamente, o TCID para cada objeto digitalizador poderá ter um valor diferente do que tinha quando o objeto RealTimeStylus Class foi habilitado pela primeira vez.

Esse método pode ser chamado mesmo se o objeto Classe RealTimeStylus não estiver habilitado, desde que a Classe RealTimeStylus não tenha terminado o processamento de dados na fila. Esse método pode ser chamado até que o último plug-in assíncrono receba o Método IStylusPlugin::RealTimeStylusDisabled.

Exemplos

O código de exemplo C++ a seguir obtém um ponteiro para o objeto IInkTablet e o usa para obter o identificador de contexto do tablet. Em seguida, ele exibe os nomes de todos os tablets anexados ao sistema na janela de saída de depuração.

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