IInkLineInfo::GetCandidate method (msinkaut.h)

Mengembalikan satu alternatif pengenalan dari daftar hasil pengenalan.

Sintaks

HRESULT GetCandidate(
  [in]  UINT   nCandidateNum,
  [out] LPWSTR pwcRecogWord,
  [out] UINT   *pcwcRecogWord,
  [in]  DWORD  dwFlags
);

Parameter

[in] nCandidateNum

Indeks berbasis nol dari entri daftar alternatif untuk diambil.

[out] pwcRecogWord

Buffer untuk menyimpan alternatif pengenalan yang dipilih. Jika pwcRecogWord adalah NULL, metode tidak mencoba mengambil kata alternatif pengenalan.

[out] pcwcRecogWord

Meneruskan panjang buffer pwcRecogWord dalam karakter Unicode, dan mengembalikan jumlah karakter Unicode yang disalin ke dalam buffer.

[in] dwFlags

Tidak digunakan.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_FAIL	Indeks nCandidateNum lebih besar sehingga jumlah pengenalan bergantian.
ERROR_MORE_DATA	Buffer pwcRecogWord tidak cukup besar untuk menerima pengakuan alternatif.

Keterangan

Jika parameter pwcRecogWord null, metode tidak mencoba mengambil kata alternatif pengenalan, tetapi hanya mengatur pwcRecogWord ke jumlah karakter dalam alternatif pengenalan.

Jika buffer pwcRecogWord tidak cukup besar untuk berisi alternatif pengenalan, maka buffer pwcRecogWord diisi dengan jumlah karakter pwcRecogWord pertama dari alternatif pengenalan.

Persyaratan

Klien minimum yang didukung	Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	msinkaut.h
Pustaka	InkObj.dll

Lihat juga

IInkLineInfo

Metode SetCandidate