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.
Menampilkan 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 |
|
| DLL |
|