Metode IStylusPlugin::CustomStylusDataAdded (rtscom.h)

Artikel
03/01/2024

Memberi tahu penerapan plug-in bahwa data stylus kustom tersedia.

Sintaks

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

Parameter

[in] piRtsSrc

Objek Kelas RealTimeStylus (RTS) yang mengirim pemberitahuan.

[in] pGuidId

Pengidentifikasi unik global (GUID) untuk data kustom.

[in] cbData

Ukuran, dalam karakter, dari buffer, pbData. Nilai yang valid adalah 0 hingga 0x7FFF, inklusif.

[in] pbData

Penunjuk ke buffer yang berisi data kustom yang dikirim oleh objek RTS.

Nilai kembali

Untuk deskripsi nilai pengembalian, lihat Kelas dan Antarmuka RealTimeStylus.

Keterangan

Metode ini dipanggil ketika Metode IStylusPlugin::CustomStylusDataAdded sedang diproses. Data kustom diteruskan di anggota pbData , dengan GUID di anggota pGuidId untuk meneruskan informasi jenis. Kelas ini tidak dapat diwariskan.

Contoh

Contoh kode C++ berikut mengimplementasikan metode Metode IStylusPlugin::CustomStylusDataAdded yang menangani data dari peristiwa gerakan dan mengatur kontrol teks statis, m_pStatusControl, ke representasi string data gerakan.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	rtscom.h
DLL	RTSCom.dll