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 |