Metode IInkStrokeDisp::GetPacketData (msinkaut.h)

Artikel
03/05/2024

Mengambil data paket untuk berbagai paket dalam objek IInkStrokeDisp .

Sintaks

HRESULT GetPacketData(
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketData
);

Parameter

[in, optional] Index

Opsional. Titik awal indeks berbasis nol ke paket dalam goresan. Nilai default ISC_FirstElement, yang ditentukan dalam jenis enumerasi InkSelectionConstants , menentukan paket pertama.

[in, optional] Count

Opsional. Jumlah himpunan data paket titik yang harus dikembalikan, dimulai dengan paket yang ditentukan dalam parameter startingIndex . Nilai default ISC_AllElements, yang ditentukan dalam jenis enumerasi InkSelectionConstants , menentukan semua titik yang membentuk data goresan.

[out, retval] PacketData

Ketika metode ini kembali, berisi array bilangan bulat 32-bit yang ditandatangani yang berisi data paket untuk titik yang diminta dalam goresan. Array berisi data untuk titik pertama, lalu data untuk titik kedua, dan sebagainya.

Untuk informasi selengkapnya tentang struktur VARIAN, lihat Menggunakan Pustaka COM.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_POINTER	Parameter berisi penunjuk yang tidak valid.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.
E_OUTOFMEMORY	Tidak dapat mengalokasikan objek pembantu penangan Stroke.
E_INVALIDARG	Goresan tidak valid.
E_INK_EXCEPTION	Pengecualian terjadi di dalam metode .
E_UNEXPECTED	Parameter atau jenis properti yang tidak terduga.

Keterangan

Jika jumlah paket dalam goresan kurang dari jumlah parameter startingIndex dan pointCount , maka array data yang dikembalikan berisi informasi paket untuk lebih sedikit poin daripada hitungan yang diminta.

Untuk mengambil deskripsi data paket, gunakan properti PacketDescription stroke. Properti ini mengembalikan array pengidentifikasi unik global (GUID) yang menunjukkan nilai properti mana yang dikembalikan oleh metode GetPacketData untuk setiap titik. Konstanta PacketProperty berisi GUID properti paket yang tersedia.

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	msinkaut.h
Pustaka	InkObj.dll