Metode IInkAnalyzer::CreateAnalysisHint

Menambahkan simpul petunjuk analisis baru dengan area tak terbatas ke IInkAnalyzer.

Sintaks

HRESULT CreateAnalysisHint(
  [out] IContextNode **ppAnalysisHint
);

Parameter

ppAnalysisHint [out]

Node petunjuk analisis baru.

Menampilkan nilai

Lihat Kelas dan Antarmuka - Analisis Tinta untuk deskripsi nilai yang dikembalikan.

Keterangan

Perhatian

Untuk menghindari kebocoran memori, panggil IUnknown::Release di ppAnalysisHint saat Anda tidak perlu lagi menggunakan objek .

Untuk memberikan informasi konteks tambahan untuk IInkAnalyzer, Anda dapat menambahkan petunjuk analisis ke penganalisis tinta. Petunjuk analisis dapat meningkatkan akurasi pengenalan. Misalnya, Anda dapat menambahkan informasi factoid dan panduan untuk bidang dalam aplikasi formulir.

Metode ini membuat IContextNode baru dengan jenis node konteks AnalysisHint (lihat IContextNode::GetType) dan menambahkan petunjuk baru sebagai subnode dari simpul akar objek IInkAnalyzer (lihat IContextNode::GetSubNodes dan IInkAnalyzer::GetRootNode Method).

Untuk menambahkan informasi konteks ke petunjuk, gunakan IContextNode::AddPropertyData dengan parameter pPropertyDataId yang diatur ke salah satu konstanta Properti Petunjuk Analisis .

Jika petunjuk diberi area tak terbatas, disebut petunjuk global, IInkAnalyzer menerapkan konteks petunjuk ke semua tinta yang tidak berada dalam area petunjuk lain. Beberapa petunjuk dapat dilampirkan ke satu IInkAnalyzer. Namun, hanya satu petunjuk global yang dapat dilampirkan ke satu penganalisis tinta, dan tidak ada petunjuk non-global yang dapat tumpang tindih. Untuk informasi selengkapnya tentang jenis informasi konteks yang dapat diberikan petunjuk, lihat Analisis Properti Petunjuk.

Menambahkan petunjuk analisis tidak menandai area petunjuk untuk analisis ulang. Untuk menandai area dalam petunjuk untuk analisis ulang, gunakan Metode IInkAnalyzer::SetDirtyRegion untuk mengatur wilayah kotor ke penyatuan wilayah kotor saat ini dan area petunjuk analisis.

Saat menggunakan petunjuk untuk aplikasi formulir, aplikasi harus menghindari pencampuran konteks teks dengan tinta dalam formulir. Ini berarti misalnya bahwa nama bidang teks tidak boleh dibuat di pohon analisis. Petunjuk dimaksudkan untuk mengaitkan tinta ke area di halaman; konteks teks apa pun mengganggu asosiasi tinta ke petunjuk ini. Operasi analisis dapat menggabungkan tinta dan konteks teks di wilayah penulisan yang sama yang akan mencegah tinta dikaitkan dengan area petunjuk.

Untuk informasi selengkapnya tentang analisis tinta, lihat Gambaran Umum Analisis Tinta.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Header	IACom.h (juga memerlukan IACom_i.c)
DLL	IACom.dll

Lihat juga

IInkAnalyzer

IContextNode::AddPropertyData

Metode IInkAnalyzer::D eleteAnalysisHint

Metode IInkAnalyzer::GetAnalysisHints

Metode IInkAnalyzer::GetAnalysisHintsByName

Properti Petunjuk Analisis

Referensi Analisis Tinta