Método IStylusPlugin::CustomStylusDataAdded (rtscom.h)

Notifica al complemento de implementación que están disponibles los datos de lápiz óptico personalizados.

Sintaxis

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

Parámetros

[in] piRtsSrc

Objeto De clase RealTimeStylus (RTS) que envió la notificación.

[in] pGuidId

Identificador único global (GUID) de los datos personalizados.

[in] cbData

Tamaño, en caracteres, del búfer, pbData. Los valores válidos son de 0 a 0x7FFF, ambos incluidos.

[in] pbData

Puntero al búfer que contiene los datos personalizados enviados por el objeto RTS.

Valor devuelto

Para obtener una descripción de los valores devueltos, vea RealTimeStylus Classes and Interfaces (Clases e interfaces de RealTimeStylus).

Comentarios

Se llama a este método cuando se está procesando el método IStylusPlugin::CustomStylusDataAdded . Los datos personalizados se pasan en el miembro pbData , con un GUID en el miembro pGuidId para pasar información de tipo. Esta clase no puede heredarse.

Ejemplos

El siguiente ejemplo de código de C++ implementa un método IStylusPlugin::CustomStylusDataAdded método que controla los datos de un evento de gesto y establece un control de texto estático, m_pStatusControl, en una representación de cadena de los datos de gestos.

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado rtscom.h
Archivo DLL RTSCom.dll

Consulte también

Clase GestureRecognizer

Interfaz IGestureRecognizer

IStylusAsyncPlugin

IStylusPlugin (Interfaz)

IStylusSyncPlugin