Fungsi GetUnicodeRanges (recapis.h)

Mengembalikan rentang titik Unicode yang didukung pengenal.

Sintaks

HRESULT GetUnicodeRanges(
  HRECOGNIZER     hrec,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

Parameter

hrec

Tangani ke pengenal.

pcRanges

Pada input, jumlah rentang yang dapat ditahan oleh buffer pcr . Pada output, jumlah rentang yang dikandung buffer pcr .

pcr

Array struktur CHARACTER_RANGE . Setiap struktur berisi berbagai titik Unicode yang didukung pengenal. Urutan array bersifat arbitrer. Untuk menentukan ukuran buffer yang diperlukan, atur pcr ke NULL; gunakan jumlah rentang untuk mengalokasikan buffer pcr .

Nilai kembali

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_POINTER	Salah satu parameter adalah penunjuk yang tidak valid.
TPC_E_INSUFFICIENT_BUFFER	Buffer pcr terlalu kecil.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.
E_INVALIDARG	Argumen yang tidak valid diterima.
E_OUTOFMEMORY	Memori tidak cukup.

Keterangan

Fungsi ini bersifat opsional.

Beberapa pengenal tidak mendukung kemampuan ini, tetapi mungkin masih menyertakan fungsi Fungsi GetUnicodeRanges . Untuk pengenal tersebut, fungsi GetUnicodeRanges mengembalikan E_NOTIMPL.

Untuk mengontrol rentang Unicode yang digunakan oleh konteks recognizer tertentu, gunakan fungsi GetEnabledUnicodeRanges dan SetEnabledUnicodeRanges . Rentang ini dibatasi menjadi subset dari rentang yang dikembalikan oleh GetUnicodeRanges.

Pengenal gerakan Microsoft menggunakan karakter Unicode dari 0xF000 ke 0xF0FF. Setiap nilai Unicode tunggal dalam rentang ini mewakili satu gerakan. Untuk daftar lengkap nilai Unicode untuk gerakan, lihat Nilai Rentang Gerakan Unicode.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP Tablet PC Edition [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	recapis.h
DLL	inkobjcore.dll

Lihat juga

Fungsi GetEnabledUnicodeRanges

Fungsi SetEnabledUnicodeRanges