Metode IInkStrokeDisp::GetPacketValuesByProperty (msinkaut.h)

Artikel
08/25/2023

Mengambil data untuk properti paket yang diketahui dari satu atau beberapa paket dalam stroke.

Sintaks

HRESULT GetPacketValuesByProperty(
  [in]           BSTR    PropertyName,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketValues
);

Parameter

[in] PropertyName

Pengidentifikasi dari konstanta PacketProperty yang digunakan untuk memilih data paket mana yang diambil.

Untuk informasi selengkapnya tentang jenis data BSTR, lihat Menggunakan Pustaka COM.

[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

Pilihan. Jumlah titik yang membentuk data goresan. Nilai default ISC_AllElements, yang ditentukan dalam jenis enumerasi InkSelectionConstants , menentukan semua titik yang membentuk data goresan.

[out, retval] PacketValues

Ketika metode ini kembali, berisi array bilangan bulat 32-bit yang ditandatangani yang menentukan nilai PacketProperty yang diminta untuk setiap titik yang diminta dari goresan.

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.
TPC_E_INVALID_STROKE	Goresan tidak valid.
E_POINTER	Parameter berisi penunjuk yang tidak valid.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.
E_OUTOFMEMORY	Tidak dapat mengalokasikan array data paket.
E_INVALIDARG	Properti indeks, jumlah, atau paket tidak valid.
E_INK_EXCEPTION	Pengecualian terjadi di dalam metode .
CO_E_CLASSSTRING	Format GUID tidak valid.

Keterangan

Properti paket tertentu mungkin tidak tersedia pada objek IInkStrokeDisp tertentu. PC Tablet mungkin memiliki lebih dari satu tablet untuk input pengguna. Koleksi InkTablets berisi daftar semua tablet yang dilampirkan ke PC Tablet. Gunakan metode IsPacketPropertySupported untuk menentukan apakah properti paket tertentu didukung oleh objek IInkTablet tertentu atau oleh semua tablet yang tersedia. Selain itu, gunakan properti DesiredPacketDescription dari pengumpul tinta untuk mengontrol properti paket mana yang dikumpulkan pada stroke baru.

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