GetEnabledUnicodeRanges 関数 (recapis.h)

コンテキストで有効になっている Unicode ポイント範囲の一覧を取得します。 有効な範囲を指定するために SetEnabledUnicodeRanges 関数を呼び出さない場合、この関数は認識エンジンの既定の Unicode ポイント範囲を返します。

構文

HRESULT GetEnabledUnicodeRanges(
  HRECOCONTEXT    hrc,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

パラメーター

hrc

認識エンジン コンテキストへのハンドル。

pcRanges

入力時に、pcr バッファーに含めることができるCHARACTER_RANGE構造体の数。 出力時に、 pcr バッファーに含まれる範囲の数。

pcr

CHARACTER_RANGE構造体の配列。 各構造体には、コンテキストで有効になっている Unicode ポイントの範囲が含まれています。 配列の順序は任意です。 バッファーのサイズを決定するには、 pcr を NULL に設定します。範囲の数を使用して 、pcr バッファーを割り当てます。

戻り値

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

リターン コード 説明
S_OK
 正常終了しました。
E_POINTER
 パラメーターの 1 つが無効なポインターです。
E_FAIL
 未指定のエラーが発生しました。
E_INVALIDARG
 無効な引数を受け取った。
TPC_E_INSUFFICIENT_BUFFER
 pcr バッファーが小さすぎます。
E_OUTOFMEMORY
 メモリ不足です。

注釈

この関数は省略可能です。

一部の認識エンジンでは、特定の Unicode ポイントの有効化と無効化はサポートされていませんが、 GetEnabledUnicodeRanges 関数が含まれている場合もあります。 このような認識エンジンの 場合、GetEnabledUnicodeRanges 関数はGetUnicodeRanges 関数と同じ範囲を返します。

Microsoft ジェスチャ認識エンジンは、0xF000の Unicode 文字を使用して0xF0FFします。 この範囲内の各 Unicode 値は、1 つのジェスチャを表します。 ジェスチャの Unicode 値の完全な一覧については、「ジェスチャの Unicode 範囲の値」を参照してください。

要件

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

こちらもご覧ください

CHARACTER_RANGE構造体

GetUnicodeRanges 関数

SetEnabledUnicodeRanges 関数

  • Last updated on