SetEnabledUnicodeRanges 関数 (recapis.h)

コンテキストで 1 つ以上の Unicode ポイント範囲を有効にします。

構文

HRESULT SetEnabledUnicodeRanges(
  HRECOCONTEXT    hrc,
  ULONG           cRanges,
  CHARACTER_RANGE *pcr
);

パラメーター

hrc

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

cRanges

pRanges バッファー内の範囲の数。

pcr

CHARACTER_RANGE構造体の配列。各構造体は、認識エンジンで有効にする Unicode ポイントの範囲を識別します。配列の順序は任意です。

戻り値

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

リターンコード	Description
S_OK	成功。
TPC_S_TRUNCATED	認識エンジンは、指定された Unicode ポイント範囲の 1 つをサポートしていません。
E_FAIL	指定されていないエラーが発生しました。
E_INVALIDARG	無効な引数を受け取りました。
E_POINTER	パラメーターの 1 つが無効なポインターです。

注釈

SetEnabledUnicodeRanges 関数は省略可能です。

一部の認識エンジンは、特定のコードポイントの有効化と無効化をサポートしていませんが、 SetEnabledUnicodeRanges 関数を含めることができます。このような認識エンジンの場合、 SetEnabledUnicodeRanges 関数は E_NOTIMPLを返します。

各認識エンジンは、1 つ以上の Unicode ポイント範囲をサポートします。認識エンジンがサポートする Unicode ポイント範囲を特定するには、 GetUnicodeRanges 関数を呼び出します。この関数を呼び出さない場合、認識エンジンは Unicode ポイント範囲の既定のセットを使用します。既定の範囲は認識エンジン固有です。

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

Requirements

Requirement	価値
サポートされる最小クライアント	Windows XP タブレット PC エディション [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	サポートなし
ターゲットプラットフォームの	ウィンドウズ
Header	recapis.h
Library	inkobjcore.lib
DLL	inkobjcore.dll