Metode IInkTablet::GetPropertyMetrics (msinkaut.h)

Artikel
03/08/2023

Mengambil data metrik untuk properti tertentu.

Sintaks

HRESULT GetPropertyMetrics(
  [in]  BSTR                     propertyName,
  [out] long                     *Minimum,
  [out] long                     *Maximum,
  [out] TabletPropertyMetricUnit *Units,
  [out] float                    *Resolution
);

Parameter

[in] propertyName

Properti yang ingin Anda tentukan metriknya.

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

[out] Minimum

Nilai minimum, dalam unit logis, yang dilaporkan tablet untuk properti ini. Misalnya, tablet yang melaporkan nilai x dari 0 hingga 9000 memiliki minimum logis 0.

[out] Maximum

Nilai maksimum, dalam unit logis, yang dilaporkan tablet untuk properti ini. Misalnya, tablet yang melaporkan nilai x dari 0 hingga 9000 akan memiliki maksimum logis 9000.

[out] Units

Unit fisik properti, seperti inci atau derajat. Untuk daftar unit properti, lihat jenis enumerasi TabletPropertyMetricUnit .

[out] Resolution

Menentukan resolusi atau nilai kenaikan untuk anggota unit . Misalnya, tablet yang melaporkan 400 titik per inci (dpi) memiliki nilai resolusi 400.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
TPC_E_UNKNOWN_PROPERTY	Tablet tidak mendukung properti yang ditentukan.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.
E_POINTER	Parameter berisi penunjuk yang tidak valid.
CO_E_CLASSSTRING	Format GUID tidak valid.
E_INVALIDARG	String properti tidak diketahui.
E_INK_EXCEPTION	Terjadi pengecualian saat memproses.

Keterangan

Properti yang Anda ambil metriknya mungkin mencakup waktu saat paket dihasilkan atau tekanan bawah ujung pena pada permukaan tablet.

Untuk daftar lengkap properti yang dapat Anda ambil metriknya, lihat konstanta PacketProperty .

Catatan Mengakses properti ini dalam penangan pesan tertentu dapat mengakibatkan fungsi yang mendasar dimasukkan kembali, menyebabkan hasil yang tidak terduga. Berhati-hatilah untuk menghindari panggilan masuk kembali saat menangani salah satu pesan berikut: WM_ACTIVATE, WM_ACTIVATEAPP, WMNCACTIVATE, WM_PAINT; WM_SYSCOMMAND jika wParam diatur ke SC_HOTKEY atau SC_TASKLIST; dan WM_SYSKEYDOWN (saat memproses kombinasi kunci Alt-Tab atau Alt-Esc). Ini adalah masalah dengan aplikasi model apartemen berulir tunggal.

Persyaratan


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

Lihat juga

Metode GetPacketDescriptionPropertyMetrics

Metode GetPacketValuesByProperty

Antarmuka IInkTablet

Metode SetPacketValuesByProperty

Enumerasi TabletPropertyMetricUnit

Bagikan melalui