Metode IInkAnalyzer::AddStroke

Menambahkan data goresan untuk satu goresan ke IInkAnalyzer dan menetapkan pengidentifikasi budaya utas input aktif ke stroke.

Sintaks

HRESULT AddStroke(
  [in]  LONG         lStrokeId,
  [in]  ULONG        ulStrokePacketDataCount,
  [in]  LONG         *plStrokePacketData,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

Parameter

lStrokeId [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.

ppContextNodeStrokeAddedTo [out]

Penunjuk ke IContextNode tempat IInkAnalyzer 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 UnclassifiedInk (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 goresan dan menambahkan goresan ke simpul konteks UnclassifiedInk pertama di bawah simpul akar penganalisis tinta yang berisi goresan dengan pengidentifikasi budaya yang sama. Jika penganalisis tinta tidak memiliki simpul dengan pengidentifikasi budaya yang sama, penganalisis tinta membuat simpul konteks UnclassifiedInk baru di bawah simpul akarnya dan menambahkan stroke ke simpul konteks UnclassifiedInk baru.

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 dalam 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.

Jika IInkAnalyzer sudah mengandung stroke dengan pengidentifikasi stroke yang sama, IInkAnalyzer mengembalikan HRESULTE_INVALIDARG.

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

InkAnalyzer

Metode IInkAnalyzer::AddStrokeForLanguage

Metode IInkAnalyzer::AddStrokes

IInkAnalyzer::AddStrokesForLanguage Method

IInkAnalyzer::RemoveStroke Method

Metode IInkAnalyzer::RemoveStrokes

Referensi Analisis Tinta