次の方法で共有

SetTextContext 関数 (recapis.h)

  • [アーティクル]

認識エンジン コンテキストに含まれるテキストの前後に来るテキスト文字列を提供します。

インクを初めて処理する前に、この関数を呼び出します。 そのため、Process 関数を呼び出す前に SetTextContext 関数を呼び出します。

構文

HRESULT SetTextContext(
  HRECOCONTEXT hrc,
  ULONG        cwcBefore,
  const WCHAR  *pwcBefore,
  ULONG        cwcAfter,
  const WCHAR  *pwcAfter
);

パラメーター

hrc

認識エンジン コンテキストを処理します。

cwcBefore

pwcBefore の文字数。

pwcBefore

認識エンジン コンテキストに含まれるテキストの前にあるテキスト文字列。 文字列が NULL で終わるわけではありません。

cwcAfter

pwcAfter の文字数。

pwcAfter

認識エンジン コンテキストに含まれるテキストの後に来るテキスト文字列。 文字列が NULL で終わるわけではありません。

戻り値

この関数は、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 正常終了しました。
E_POINTER
 コンテキストが無効であるか、パラメーターの 1 つが無効なポインターです。
E_NOTIMPL
 認識エンジンは、この関数をサポートしていません。
E_OUTOFMEMORY
 操作を完了するためにメモリを割り当てることができません。
E_FAIL
 未指定のエラーが発生しました。
E_INVALIDARG
 無効な引数が指定されました。

解説

SetTextContext 関数は、語句または単語のコンテキストを提供し、認識エンジンの精度を向上させます。 たとえば、pwcBefore pwcBefore 文字列が "under the " で、pwcAfter 文字列が "in the house" の場合、文字列間の単語または単語を使用して認識エンジンに偏りを付けることができます。 認識エンジンは、認識を実行するときに、"the" の後と "in" の前の領域を考慮する必要があります。

ただし、 pwcAfter 文字列が "Hel" で 、pwcBefore 文字列が "o" の場合、文字列間にスペースが不足している場合、認識エンジンは、"Hel" で始まり、"o" で終わる単語内の 1 つ以上の文字を認識する必要があることを示します。

テキスト コンテキストの長さは、左右のコンテキストごとに 1024 文字以下に制限することをお勧めします。

要件

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