Метод IStylusPlugin::CustomStylusDataAdded (rtscom.h)

Статья
03/01/2024

Уведомляет реализующий подключаемый модуль о доступности данных пользовательского пера.

Синтаксис

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

Параметры

[in] piRtsSrc

Объект класса RealTimeStylus (RTS), отправляющий уведомление.

[in] pGuidId

Глобальный уникальный идентификатор (GUID) для пользовательских данных.

[in] cbData

Размер (в символах) буфера pbData. Допустимые значения: от 0 до 0x7FFF включительно.

[in] pbData

Указатель на буфер, содержащий пользовательские данные, отправленные объектом RTS.

Возвращаемое значение

Описание возвращаемых значений см. в разделе Классы и интерфейсы RealTimeStylus.

Этот метод вызывается при обработке метода IStylusPlugin::CustomStylusDataAdded . Пользовательские данные передаются в элемент pbData с GUID в элементе pGuidId для передачи сведений о типе. Этот класс не наследуется.

Примеры

В следующем примере кода C++ реализуется метод метода IStylusPlugin::CustomStylusDataAdded, который обрабатывает данные из события жеста и задает статический текстовый элемент управления , в m_pStatusControlстроковое представление данных жеста.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	rtscom.h
DLL	RTSCom.dll