Método IStylusPlugin::CustomStylusDataAdded (rtscom.h)
Notifica o plug-in de implementação de que os dados de caneta personalizados estão disponíveis.
Sintaxe
HRESULT CustomStylusDataAdded(
[in] IRealTimeStylus *piRtsSrc,
[in] const GUID *pGuidId,
[in] ULONG cbData,
[in] const BYTE *pbData
);
Parâmetros
[in] piRtsSrc
O objeto classe RealTimeStylus (RTS) que enviou a notificação.
[in] pGuidId
O GUID (identificador global exclusivo) para os dados personalizados.
[in] cbData
O tamanho, em caracteres, do buffer, pbData. Os valores válidos são de 0 a 0x7FFF, inclusive.
[in] pbData
Um ponteiro para o buffer que contém os dados personalizados enviados pelo objeto RTS.
Retornar valor
Para obter uma descrição dos valores retornados, consulte Classes e interfaces RealTimeStylus.
Comentários
Esse método é chamado quando o método IStylusPlugin::CustomStylusDataAdded está sendo processado. Os dados personalizados são passados no membro pbData , com um GUID no membro pGuidId para passar informações de tipo. Essa classe não pode ser herdada.
Exemplos
O exemplo de código C++ a seguir implementa um método de método IStylusPlugin::CustomStylusDataAdded que manipula os dados de um evento de gesto e define um controle de texto estático, m_pStatusControl, para uma representação de cadeia de caracteres dos dados de gesto.
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 | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP Tablet PC Edition [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | rtscom.h |
| DLL | RTSCom.dll |