IStylusPlugin::CustomStylusDataAdded 메서드(rtscom.h)

아티클
03/05/2024

구현 플러그 인에 사용자 지정 스타일러스 데이터를 사용할 수 있음을 알릴 수 있습니다.

구문

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

매개 변수

[in] piRtsSrc

알림을 보낸 RTS( RealTimeStylus Class ) 개체입니다.

[in] pGuidId

사용자 지정 데이터에 대한 GUID(Globally Unique Identifier)입니다.

[in] cbData

버퍼의 크기(chars)인 pbData입니다. 유효한 값은 0부터 0x7FFF( 포함)입니다.

[in] pbData

RTS 개체에서 보낸 사용자 지정 데이터를 포함하는 버퍼에 대한 포인터입니다.

반환 값

반환 값에 대한 설명은 RealTimeStylus 클래스 및 인터페이스를 참조하세요.

설명

이 메서드는 IStylusPlugin::CustomStylusDataAdded 메서드 가 처리될 때 호출됩니다. 사용자 지정 데이터는 pbData 멤버에 전달되며 pGuidId 멤버의 GUID를 사용하여 형식 정보를 전달합니다. 이 클래스는 상속될 수 없습니다.

예제

다음 C++ 코드 예제에서는 제스처 이벤트의 데이터를 처리하고 정적 텍스트 컨트롤 m_pStatusControl를 제스처 데이터의 문자열 표현으로 설정하는 IStylusPlugin::CustomStylusDataAdded 메서드 메서드를 구현합니다.

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 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	rtscom.h
DLL	RTSCom.dll