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

認識結果リストに 1 つの認識代替を更新します。既存の代替候補を置き換えるか、代替候補をリストに追加します。

構文

HRESULT SetCandidate(
  [in] UINT   nCandidateNum,
  [in] LPWSTR strRecogWord
);

パラメーター

[in] nCandidateNum

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

[in] strRecogWord

新しい代替テキストへのポインター。

戻り値

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

リターン コード	説明
S_OK	メソッドが成功しました。
E_FAIL	nCandidateNum インデックスが範囲外です。
E_OUTOFMEMORY	操作を完了できませんでした。 認識結果リストは変更されません。

解説

候補リストは、現在のリストの最後に、一度に 1 つの新しいエントリによってのみ拡張できます。 たとえば、 テキスト インク オブジェクト (tInk) に現在 10 個の認識結果がある場合、 nCandidateNum パラメーターを 10 に設定すると、テキスト インク オブジェクトの認識結果リストに新しい結果が追加されます。

要件

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

関連項目

GetCandidate メソッド

IInkLineInfo