Metode IInkTablet::IsPacketPropertySupported (msinkaut.h)

Artikel
03/05/2024

Menentukan apakah properti perangkat tablet atau kumpulan perangkat tablet, yang diidentifikasi dengan pengidentifikasi unik global (GUID), didukung. Misalnya, gunakan metode ini untuk menentukan apakah semua tablet dalam koleksi mendukung tekanan tangenial dari pena.

Sintaks

HRESULT IsPacketPropertySupported(
  [in]          BSTR         packetPropertyName,
  [out, retval] VARIANT_BOOL *Supported
);

Parameter

[in] packetPropertyName

GUID untuk GUID PacketProperty tablet atau tablet yang diminta. Gunakan konstanta BSTR yang ditentukan dari konstanta PacketProperty .

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

[out, retval] Supported

VARIANT_TRUE jika properti yang diketahui didukung oleh tablet atau tablet; jika tidak, VARIANT_FALSE.

Catatan Metode ini dapat dimasukkan kembali ketika dipanggil dalam penangan pesan tertentu, menyebabkan hasil yang tidak terduga. Berhati-hatilah untuk menghindari panggilan masuk kembali saat menangani salah satu pesan berikut: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, 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.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_POINTER	Parameter berisi penunjuk yang tidak valid.
CO_E_CLASSSTRING	Format GUID tidak valid.
E_INK_EXCEPTION	Terjadi pengecualian saat memproses.
E_INVALIDARG	Bendera tidak valid.

Keterangan

Catatan Ketika metode ini dipanggil pada koleksi InkTablets , metode ini meminta semua tablet pada sistem. Jika salah satu dari mereka tidak mendukung properti , ia mengembalikan FALSE. Panggil IsPacketPropertySupported pada objek IInkTablet individual untuk menentukan apakah perangkat mendukung properti yang diketahui.

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

Lihat juga

Metode GetPacketData

Antarmuka IInkTablet

Metode SetPacketValuesByProperty

Bagikan melalui