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

Weitere Informationen

GestureRecognizer-Klasse

IGestureRecognizer-Schnittstelle

Istylusasyncplugin

IStylusPlugin-Schnittstelle

Istylussyncplugin