Metode IStrokeBuilder::AppendPackets (rtscom.h)

Artikel
03/01/2024

Menambahkan paket ke akhir daftar paket input digitizer.

Sintaks

HRESULT AppendPackets(
  [in] TABLET_CONTEXT_ID tcid,
  [in] STYLUS_ID         sid,
  [in] ULONG             cPktBuffLength,
  [in] const LONG        *pPackets
);

Parameter

[in] tcid

Pengidentifikasi konteks untuk perangkat tablet tempat stylus berada.

[in] sid

Pengidentifikasi objek stylus.

[in] cPktBuffLength

Jumlah LONG dalam array pPackets bukan ukuran dalam byte. Nilai yang valid adalah antara 0 dan 0x7FFF, inklusif.

[in] pPackets

Awal data paket. Sampel ini bersifat baca-saja.

Mengembalikan nilai

Untuk deskripsi nilai yang dikembalikan, lihat Kelas dan Antarmuka RealTimeStylus.

Keterangan

Metode ini harus dipanggil ketika paket data dikirim sebagai akibat dari stylus yang bergerak saat menyentuh atau dalam rentang digitizer.

Catatan Data paket masuk dalam format Himetric dan harus dikonversi menjadi piksel.

Contoh

Contoh C++ berikut menunjukkan implementasi metode Metode IStylusPlugin::P ackets pada objek Antarmuka IStylusPlugin . Plug-in menggunakan objek StrokeBuilder untuk membuat goresan tinta baru. Metode Metode IStrokeBuilder::AppendPackets dipanggil dari Metode IStylusPlugin::P ackets untuk menambahkan data paket baru ke goresan yang sedang berlangsung saat pengguna menyeret stylus di seluruh digitizer.

STDMETHODIMP CStrokeBuilderPlugin::Packets( 
            /* [in] */ IRealTimeStylus *piRtsSrc,
            /* [in] */ const StylusInfo *pStylusInfo,
            /* [in] */ ULONG cPktCount,
            /* [in] */ ULONG cPktBuffLength,
            /* [size_is][in] */ LONG *pPackets,
            /* [out][in] */ ULONG *pcInOutPkts,
            /* [out][in] */ LONG **ppInOutPkts)
{
	// Add packet to the stroke
	return m_pStrokeBuilder->AppendPackets(pStylusInfo->tcid, pStylusInfo->cid, cPktBuffLength, pPackets);
}

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