ボックス入力またはライン入力に使用する認識ガイドを設定します。 コンテキストにストロークを追加する前に、この関数を呼び出す必要があります。
構文
HRESULT SetGuide(
HRECOCONTEXT hrc,
const RECO_GUIDE *pGuide,
ULONG iIndex
);
パラメーター
hrc
認識エンジン コンテキストへのハンドル。
pGuide
ボックスまたは行の入力に使用するガイド。 このパラメーターを NULL に設定すると、コンテキストにガイドがないことを意味します。 これは既定であり、認識エンジンが空き入力モードであることを意味します。 ガイドの詳細については、 RECO_GUIDE 構造を参照してください。
iIndex
コンテキスト内の最初のボックスまたは行に使用するインデックス値。
戻り値
この関数は、これらの値のいずれかを返すことができます。
| リターン コード | Description |
|---|---|
|
成功。 |
|
コンテキストが無効であるか、パラメーターの 1 つが無効なポインターです。 |
|
操作を完了するためにメモリを割り当てることができません。 |
|
認識エンジンでサポートされていない認識モード (フリー、ライン、ボックス化など) を設定しようとしました。または、RECO_GUIDEフィールドの値が無効です (負の高さや幅など)。 |
|
指定されていないエラーが発生しました。 |
|
reco コンテキストにインクが既にある場合、または東アジア文字の認識エンジンの場合は、 SetCACMode が以前に呼び出されたときにガイドを設定しようとしました。 |
注釈
ガイド ボックスには、 iIntex 値に基づいて番号が付けられます。
Requirements
| Requirement | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP タブレット PC エディション [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | サポートなし |
| ターゲット プラットフォーム の | ウィンドウズ |
| Header | recapis.h |
| Library | inkobjcore.lib |
| DLL | inkobjcore.dll |