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

Recupera um objeto IInkTablet Interface para o chamador.

Sintaxe

HRESULT GetTablet(
  [out, retval] IInkTablet **ppiSingleTablet
);

Parâmetros

[out, retval] ppiSingleTablet

Um ponteiro para o objeto IInkTablet Interface .

Retornar valor

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

Comentários

Esse método retorna, ppiSingleTablet conterá NULL quando RealTimeStylus estiver recebendo dados de mais de um tablet. Por exemplo, quando o método IRealTimeStylus::SetAllTabletsMode é chamado com um valor TRUE em um computador com um digitalizador e um mouse.

Exemplos

O código de exemplo C++ a seguir obtém um ponteiro para o objeto IInkTablet Interface e usa esse ponteiro para obter o identificador Plug and Play do tablet.

// 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

IInkTablet Interface

IRealTimeStylus

Classe RealTimeStylus