Metode IInkAnalyzer::AddStrokes
Menambahkan data goresan untuk beberapa goresan ke IInkAnalyzer dan menetapkan pengidentifikasi budaya utas input aktif ke goresan.
Sintaks
HRESULT AddStrokes(
[in] ULONG ulStrokeIdsCount,
[in] LONG *plStrokeIds,
[in] ULONG ulStrokePacketDescriptionCount,
[in] GUID *pStrokePacketDescriptionGuids,
[in] ULONG *pulPacketDataCountPerStroke,
[in] LONG *plStrokePacketData,
[out] IContextNode **ppContextNodeStrokeAddedTo
);
Parameter
-
ulStrokeIdsCount [in]
-
Jumlah goresan yang akan ditambahkan.
-
plStrokeIds [in]
-
Array yang berisi pengidentifikasi stroke.
-
ulStrokePacketDescriptionCount [in]
-
Jumlah properti di setiap paket.
-
pStrokePacketDescriptionGuids [in]
-
Array yang berisi pengidentifikasi properti paket.
-
pulPacketDataCountPerStroke [in]
-
Array yang berisi jumlah paket di setiap goresan.
-
plStrokePacketData [in]
-
Array yang berisi data paket untuk 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 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 stroke 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 goresan ke simpul konteks UnclassifiedInk baru.
plStrokePacketData berisi data paket untuk semua goresan. 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.
Catatan
Hanya goresan dengan deskripsi paket yang sama yang dapat ditambahkan dalam satu panggilan ke Metode IInkAnalyzer::AddStrokes.
Metode ini memperluas wilayah kotor ke persatuan nilai wilayah saat ini dan kotak pembatas dari goresan yang ditambahkan.
Jika IInkAnalyzer sudah mengandung stroke dengan pengidentifikasi yang sama dengan salah satu goresan yang akan ditambahkan, 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 |
|
| DLL |
|