共用方式為


IInkLineInfo::GetCandidate 方法 (msinkaut.h)

從辨識結果清單中傳回一個辨識替代專案。

語法

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

參數

[in] nCandidateNum

要擷取之替代清單專案之以零起始的索引。

[out] pwcRecogWord

要在其中儲存所選辨識替代的緩衝區。 如果 pwcRecogWordNull,此方法不會嘗試擷取辨識替代字。

[out] pcwcRecogWord

以 Unicode 字元傳遞 pwcRecogWord 緩衝區的長度,並傳回復制到緩衝區的 Unicode 字元數目。

[in] dwFlags

未使用。

傳回值

這個方法可以傳回其中一個值。

傳回碼 描述
S_OK
此方法已成功。
E_FAIL
nCandidateNum索引大於辨識替代數目。
ERROR_MORE_DATA
pwcRecogWord緩衝區不夠大,無法接受辨識替代。

備註

如果 pwcRecogWord 參數為 null,則方法不會嘗試擷取辨識替代字,但只會將 pwcRecogWord 設定為辨識替代中的字元數。

如果 pwcRecogWord 緩衝區不足以包含辨識替代專案,則 pwcRecogWord 緩衝區會填入辨識替代字元的第一個 pwcRecogWord 數目。

需求

   
最低支援的用戶端 Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 msinkaut.h
程式庫 InkObj.dll

另請參閱

IInkLineInfo

SetCandidate 方法