次の方法で共有

SetFlags 関数 (recapis.h)

  • [アーティクル]

認識エンジンがインクを解釈し、結果文字列を決定する方法を指定します。

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

構文

HRESULT SetFlags(
  [in] HRECOCONTEXT hrc,
  [in] DWORD        dwFlags
);

パラメーター

[in] hrc

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

[in] dwFlags

次の表に、認識エンジンがインクを解釈して結果文字列を決定する方法を指定するために設定できるフラグの一覧を示します。 必要に応じて 、OR 演算子 (|) を使用してフラグを結合します。

ビット フラグ 意味
RECOFLAG_AUTOSPACE
 認識エンジンでは、言語モデルの規則に基づいてスマートな間隔が使用されます。
RECOFLAG_COERCE
 認識エンジンは、コンテキストに指定した factoid に基づいて結果を強制します。 たとえば、電話番号 factoid を指定し、ユーザーが "hello" という単語を入力すると、認識エンジンはランダムな電話番号または空の文字列を返す場合があります。 このフラグを指定しない場合、認識エンジンは結果として "hello" を返します。
RECOFLAG_PREFIXOK
 認識エンジンは、既定または指定された (factoid) 言語モデルで定義されている文字列のプレフィックス部分の認識をサポートします。

たとえば、このフラグがない場合、ユーザーは "handw" を書き込み、認識エンジンは認識エンジン辞書に存在する単語である提案 ("hander" や "handed" など) を返します。 フラグを使用すると、認識エンジンは、認識エンジンの辞書に存在する単語 "手書き" の有効なプレフィックスであるため、提案の 1 つとして "handw" を返す場合があります。

タブレット PC 入力パネルは、入力スコープがIS_DEFAULT (または入力スコープなし) の場合や、ユーザーの単語リストや正規表現がない場合を除き、ほとんどの場合にこのフラグを設定します。

東アジア文字の認識エンジンは、呼び出し元がこのフラグを渡すときにE_INVALIDARGを返す必要があります。
RECOFLAG_LINEMODE
 認識エンジンは行を分割しませんが、文字と単語の分離を行う必要があります。 これは、ガイドがなく、すべてのインクが 1 行であると見なされる点を除き、線モードと同じです。 このフラグを設定すると、ガイド (設定されている場合) は無視されます。
RECOFLAG_SINGLESEG
 複数のセグメント化を無効にします。 既定では、認識エンジンはインクの複数のセグメント化 (代替) を返します。

たとえば、"一緒に" を個別のストロークとして書き込む場合、認識エンジンはインクを "get her"、"to gather"、または "together" としてセグメント化できます。 代替のクエリを実行するときにインクの複数のセグメント化が必要ない場合は、このフラグを設定します。 これにより、パフォーマンスが向上し、メモリ使用量が削減されます。
RECOFLAG_WORDMODE
 認識エンジンは、インクを 1 つの単語として扱います。 たとえば、コンテキストに "get her" が含まれている場合、認識エンジンは "together" を返します。

戻り値

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

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

注釈

Microsoft Windows XP Tablet PC Edition Development Kit 1.7 より前のバージョンでは、タブレット PC 入力パネルでスマートな間隔が実行されました。 Tablet PC SDK 1.7 以降、入力パネルでは、予備の間隔に関する推奨事項を使用して引き続き結果が生成されます。 ただし、タブレット PC 入力パネルの間隔の結果は、認識エンジンの推奨事項 (結果) によって変更される場合があります。 認識エンジンは、テキスト コンテキスト情報 (入力パネルによって 行われた SetTextContext 呼び出しに基づく) とその内部言語モデル ルールを使用してこれを行うことができます。

入力パネルは、RECOFLAG_AUTOSPACE フラグを設定してこの関数を呼び出すことによって、認識エンジンが自動間隔を実行できるかどうかを判断できます。 認識エンジンが自動間隔をサポートしていない場合は、E_INVALIDARGが返されます。

メモSetFlags 関数では、行モードのみがサポートされています。 ボックス化モード、フリー モード、および単一行モードはサポートされていません。
 

要件

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

こちらもご覧ください

SetFactoid 関数

SetTextContext 関数