Freigeben über


IRealTimeStylus::GetTablet-Methode (rtscom.h)

Ruft ein IInkTablet Interface-Objekt an den Aufrufer ab.

Syntax

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

Parameter

[out, retval] ppiSingleTablet

Ein Zeiger auf das IInkTablet Interface-Objekt .

Rückgabewert

Eine Beschreibung der Rückgabewerte finden Sie unter RealTimeStylus-Klassen und -Schnittstellen.

Hinweise

Diese Methode gibt zurück, ppiSingleTablet enthält NULL , wenn RealTimeStylus Daten von mehr als einem Tablet empfängt. Für instance, wenn die IRealTimeStylus::SetAllTabletsMode-Methode auf einem Computer mit einem Digitalisierer und einer Maus mit dem Wert TRUE aufgerufen wird.

Beispiele

Der folgende C++-Beispielcode ruft einen Zeiger auf das IInkTablet Interface-Objekt ab und verwendet diesen Zeiger, um den Plug & Play Bezeichner des Tablets abzurufen.

// 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);
}

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile rtscom.h
DLL RTSCom.dll

Weitere Informationen

IInkTablet-Schnittstelle

IRealTimeStylus

RealTimeStylus-Klasse