IRealTimeStylus::GetAllTabletContextIds-Methode (rtscom.h)
Ruft ein Array ab, das alle derzeit aktiven Tablet-Kontextbezeichner enthält.
Syntax
HRESULT GetAllTabletContextIds(
[in, out] ULONG *pcTcidCount,
[out] TABLET_CONTEXT_ID **ppTcids
);
Parameter
[in, out] pcTcidCount
Die Anzahl der Tablet-Kontextbezeichner.
[out] ppTcids
Zeiger auf das Array von Tablet-Kontextbezeichnern
Rückgabewert
Eine Beschreibung der Rückgabewerte finden Sie unter RealTimeStylus-Klassen und -Schnittstellen.
Hinweise
Die IRealTimeStylus::GetAllTabletContextIds-Methode bietet Zugriff auf alle aktuell aktiven Tablet-Kontextbezeichner. Mit dieser Methode können Sie diese Bezeichner direkt abrufen, anstatt Daten aus IStylusPlugin::RealTimeStylusEnabled-Methodenbenachrichtigungen zwischenzuspeichern.
Der Bereich der TabletContextID-Eigenschaft ist auf einen bestimmten instance der RealTimeStylus-Klasse beschränkt. Ein Tablet-Objekt kann für jeden instance der RealTimeStylus-Klasse einen anderen eindeutigen Bezeichner aufweisen.
Beispiele
Der folgende C++-Beispielcode ruft alle Tablet-Kontextbezeichner ab und verwendet den ersten Tablet-Kontextbezeichner, um einen Zeiger auf das IInkTablet Interface-Objekt abzurufen.
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);
}
}
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 |