Freigeben über


IRealTimeStylus::SetSingleTabletMode-Methode (rtscom.h)

Ändert den Modus für das RTS-Objekt ( RealTimeStylus Class ), um Eingaben von nur einem Tablet-Objekt zu sammeln, das einen Digitizer darstellt, der an den Tablet-PC angefügt ist. Eingabeeingaben von anderen Digitizern werden vom RealTimeStylus ignoriert.

Syntax

HRESULT SetSingleTabletMode(
  [in] IInkTablet *piTablet
);

Parameter

[in] piTablet

Das IInkTablet Interface-Objekt , das das an den Tablet-PC angefügte Digitizergerät darstellt.

Rückgabewert

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

Hinweise

Eine RealTimeStylus-Klasse kann auf einen von zwei Tablet-bezogenen Modi festgelegt werden:

  • Modus "Alle Tablets" (Standard)
  • Einzeltablettmodus
Wenn IRealTimeStylus::SetAllTabletsMode-Methode () zuerst aufgerufen und realTimeStylus aktiviert ist, wird die TPC_E_INVALID_MODE HRESULT zurückgegeben.

Beispiele

Der folgende C++-Beispielcode legt ein IRealTimeStylus-Objekt auf den Einzeltablettenmodus fest, g_pRealTimeStylusdamit es das Tablet abrufen und seinen Plug-and-Play-Bezeichner abrufen kann. Anschließend wird das IRealTimeStylus-Objekt wieder auf den Modus "Alle Tablets" festgelegt.

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

IRealTimeStylus

RealTimeStylus-Klasse

RealTimeStylus-Referenz