IStylusPlugin::CustomStylusDataAdded-Methode (rtscom.h)
Benachrichtigt das implementierende Plug-In, dass benutzerdefinierte Eingabestiftdaten verfügbar sind.
Syntax
HRESULT CustomStylusDataAdded(
[in] IRealTimeStylus *piRtsSrc,
[in] const GUID *pGuidId,
[in] ULONG cbData,
[in] const BYTE *pbData
);
Parameter
[in] piRtsSrc
Das RTS-Objekt ( RealTimeStylus Class ), das die Benachrichtigung gesendet hat.
[in] pGuidId
Der globally unique Identifier (GUID) für die benutzerdefinierten Daten.
[in] cbData
Die Größe des Puffers pbData in Zeichen. Gültige Werte sind einschließlich 0 bis 0x7FFF.
[in] pbData
Ein Zeiger auf den Puffer, der die vom RTS-Objekt gesendeten benutzerdefinierten Daten enthält.
Rückgabewert
Eine Beschreibung der Rückgabewerte finden Sie unter RealTimeStylus-Klassen und -Schnittstellen.
Hinweise
Diese Methode wird aufgerufen, wenn die IStylusPlugin::CustomStylusDataAdded-Methode verarbeitet wird. Die benutzerdefinierten Daten werden im pbData-Member mit einer GUID im pGuidId-Member übergeben, um Typinformationen zu übergeben. Diese Klasse kann nicht vererbt werden.
Beispiele
Im folgenden C++-Codebeispiel wird eine IStylusPlugin::CustomStylusDataAdded-Methode implementiert, die die Daten eines Gestenereignisses verarbeitet und ein statisches Textsteuerelement auf m_pStatusControleine Zeichenfolgendarstellung der Gestendaten festlegt.
STDMETHODIMP CGestureHandler::CustomStylusDataAdded(
/* [in] */ IRealTimeStylus *piRtsSrc,
/* [in] */ const GUID *pGuidId,
/* [in] */ ULONG cbData,
/* [in] */ const BYTE *pbData)
{
// Did we get passed gesture data?
if (*pGuidId == GUID_GESTURE_DATA)
{
// Another way to check for gestures is to see if the data
// is the right size and actually points to something
if ((cbData == sizeof(GESTURE_DATA)) && (pbData != NULL))
{
// Access the data coming as a GESTURE_DATA structure
GESTURE_DATA* pGD = (GESTURE_DATA*)pbData;
CString strStatus;
CString strGestureId;
// Helper function that maps the gesture ID to a string value
SetGestureString(pGD->gestureId, &strGestureId);
strStatus.Format(L"Gesture=%s\tConfidence=%d\tStrokes=%d", strGestureId, pGD->recoConfidence, pGD->strokeCount);
m_pStatusControl->SetWindowTextW(strStatus);
}
else
{
m_pStatusControl->SetWindowTextW(L"Not gesture data.");
}
}
else
{
m_pStatusControl->SetWindowTextW(L"Not gesture data.");
}
return S_OK;
}
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 |