次の方法で共有

IInkLineInfo::GetCandidate メソッド (msinkaut.h)

  • [アーティクル]

認識結果リストから 1 つの認識代替を返します。

構文

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

パラメーター

[in] nCandidateNum

取得する代替リスト エントリの 0 から始まるインデックス。

[out] pwcRecogWord

選択した認識代替を格納するバッファー。 pwcRecogWord が NULL の場合、メソッドは認識代替単語の取得を試みません。

[out] pcwcRecogWord

pwcRecogWord バッファーの長さを Unicode 文字で渡し、バッファーにコピーされた Unicode 文字の数を返します。

[in] dwFlags

使用されていません。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 メソッドが成功しました。
E_FAIL
 nCandidateNum インデックスは、認識代替の数よりも大きくなります。
ERROR_MORE_DATA
 pwcRecogWord バッファーは、認識代替を受け入れるのに十分な大きさではありません。

解説

pwcRecogWord パラメーターが null の場合、メソッドは認識代替単語の取得を試みますが、pwcRecogWord を認識代替の文字数に設定するだけです。

pwcRecogWord バッファーが認識代替を格納するのに十分な大きさでない場合、pwcRecogWord バッファーには認識代替からの最初の pwcRecogWord 文字数が入力されます。

要件

   
サポートされている最小のクライアント Windows XP タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー msinkaut.h
Library InkObj.dll

関連項目

IInkLineInfo

SetCandidate メソッド