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

Modifica o modo do objeto RTS (Classe RealTimeStylus ) para coletar entrada de apenas um objeto tablet que representa um digitalizador anexado ao Tablet PC. A entrada stylus de outros digitalizadores é ignorada pelo RealTimeStylus.

Sintaxe

HRESULT SetSingleTabletMode(
  [in] IInkTablet *piTablet
);

Parâmetros

[in] piTablet

O objeto IInkTablet Interface que representa o dispositivo digitalizador anexado ao Tablet PC.

Retornar valor

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

Comentários

Uma classe RealTimeStylus pode ser definida como um dos dois modos relacionados ao tablet:

• Modo todos os tablets (padrão)
• Modo tablet único

Se o Método IRealTimeStylus::SetAllTabletsMode () foi inicialmente chamado e o RealTimeStylus está habilitado, o TPC_E_INVALID_MODE HRESULT é retornado.

Exemplos

O código de exemplo C++ a seguir define um objeto IRealTimeStylus , g_pRealTimeStylus, como modo tablet único para que ele possa obter o tablet e recuperar seu identificador plug-and-play. Em seguida, ele define o objeto IRealTimeStylus de volta para o modo de todos os tablets.

// Must be in single tablet mode for GetTablet to succeed. This call to
// SetSingleTabletMode() would likely happen somewhere else in the app.
if (SUCCEEDED(g_pRealTimeStylus->SetSingleTabletMode(pInkTablet)))
{
    IInkTablet* pTablet = NULL;

    if ((SUCCEEDED(g_pRealTimeStylus->GetTablet(&pTablet))) && (NULL != pTablet))
    {
        BSTR bstrPnPID;

        if (SUCCEEDED(pTablet->get_PlugAndPlayId(&bstrPnPID)))
        {
            TRACE("The tablet's Plug-n-Play ID is: %s\n", bstrPnPID);
        }
    }

    // Restore all tablets mode.
    g_pRealTimeStylus->SetAllTabletsMode(TRUE);
}

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

Classe RealTimeStylus

Referência de RealTimeStylus