Metodo IStylusPlugin::CustomStylusDataAdded (rtscom.h)

Articolo
03/13/2024

Notifica all'implementazione del plug-in che i dati dello stilo personalizzati sono disponibili.

Sintassi

HRESULT CustomStylusDataAdded(
  [in] IRealTimeStylus *piRtsSrc,
  [in] const GUID      *pGuidId,
  [in] ULONG           cbData,
  [in] const BYTE      *pbData
);

Parametri

[in] piRtsSrc

Oggetto RealTimeStylus Class (RTS) che ha inviato la notifica.

[in] pGuidId

Identificatore univoco globale (GUID) per i dati personalizzati.

[in] cbData

Dimensione, in caratteri, del buffer, pbData. I valori validi sono compresi tra 0 e 0x7FFF, inclusi.

[in] pbData

Puntatore al buffer contenente i dati personalizzati inviati dall'oggetto RTS.

Valore restituito

Per una descrizione dei valori restituiti, vedere Classi e interfacce RealTimeStylus.

Commenti

Questo metodo viene chiamato quando viene elaborato il metodo IStylusPlugin::CustomStylusDataAdded . I dati personalizzati vengono passati nel membro pbData , con un GUID nel membro pGuidId per passare le informazioni sul tipo. La classe non può essere ereditata.

Esempio

L'esempio di codice C++ seguente implementa un metodo IStylusPlugin::CustomStylusDataAdded che gestisce i dati da un evento movimento e imposta un controllo testo statico, m_pStatusControl, su una rappresentazione di stringa dei dati del movimento.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	rtscom.h
DLL	RTSCom.dll