Metode IInkAnalyzer::AddStrokeToCustomRecognizer

Menambahkan data goresan untuk satu goresan ke simpul pengenal kustom.

Sintaks

HRESULT AddStrokeToCustomRecognizer(
  [in]  ULONG        ulStrokeId,
  [in]  ULONG        ulStrokePacketDataCount,
  [in]  LONG         *plStrokePacketData,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [in]  IContextNode *pCustomRecognizer,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

Parameter

ulStrokeId [in]

Pengidentifikasi untuk stroke untuk ditambahkan.

ulStrokePacketDataCount [in]

Jumlah paket dalam stroke.

plStrokePacketData [in]

Array yang berisi data paket untuk goresan.

ulStrokePacketDescriptionCount [in]

Jumlah properti paket di setiap paket.

pStrokePacketDescriptionGuids [in]

Array yang berisi pengidentifikasi properti paket.

pCustomRecognizer [in]

IContextNode jenis CustomRecognizer untuk menambahkan goresan.

ppContextNodeStrokeAddedTo [out]

IContextNode tempat penganalisis tinta menambahkan goresan.

Mengembalikan nilai

Untuk deskripsi nilai yang dikembalikan, lihat Kelas dan Antarmuka - Analisis Tinta.

Keterangan

Perhatian

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

Ketika ppContextNodeStrokeAddedTo adalah NULL, itu menunjukkan bahwa pemanggil tidak tertarik pada nilai pengembalian dari metode .

IInkAnalyzer menambahkan goresan ke IContextNode jenis CustomRecognizer (lihat Jenis Node Konteks). Simpul ini berada dalam koleksi subnode simpul akar (lihat metode IInkAnalyzer::GetRootNode Method dan IContextNode::GetSubNodes ).

IInkAnalyzer menetapkan pengidentifikasi budaya utas input aktif ke stroke dan menambahkan stroke ke node UnclassifiedInk pertama di bawah node CustomRecognizer. Jika tidak ada simpul UnclassifiedInk , simpul tersebut dibuat. Jika IInkAnalysisRecognizer yang terkait dengan node CustomRecognizer tidak mendukung pengidentifikasi budaya, IInkAnalyzer terus menganalisis dan menghasilkan peringatan IAnalysisWarning . Peringatan ini memiliki nilai AnalysisWarningCodeAnalysisWarningCode_LanguageIdNotRespected.

plStrokePacketData berisi data paket untuk semua titik dalam stroke. pStrokePacketDescriptionGuids berisi pengidentifikasi unik global (GUID) yang menjelaskan jenis data paket yang disertakan untuk setiap titik di setiap goresan. Untuk daftar lengkap properti paket yang tersedia, lihat PacketPropertyGuids Constants.

Metode ini memperluas wilayah kotor ke persatuan nilai wilayah saat ini dan kotak pembatas dari stroke yang ditambahkan.

IInkAnalyzer mengembalikan HRESULTE_INVALIDARG dalam keadaan berikut.

  • IInkAnalyzer sudah mengandung stroke dengan pengidentifikasi yang sama dengan stroke yang akan ditambahkan.
  • Parameter pCustomRecognizer berisi node recognizer kustom yang terkait dengan objek IInkAnalyzer yang berbeda.
  • Parameter pCustomRecognizer berisi IContextNode yang bukan jenis CustomRecognizer.

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

Jenis Simpul Konteks

Metode IInkAnalyzer::AddStrokesToCustomRecognizer

IInkAnalyzer::CreateCustomRecognizer Method

Referensi Analisis Tinta