Win32 API 日本語リファレンス
ホーム › UI.TabletPC › IInkRecognizerGuide

IInkRecognizerGuide

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IIDd934be07-7b84-4208-9136-83c20994e905継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

. (IInkRecognizerGuide)

メソッド 12

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_WritingBox(IInkRectangle** Rectangle)

認識ガイドのうち、実際に書き込みを行える不可視の書き込み領域を取得または設定します。(Get)

RectangleIInkRectangle**outユーザーが書き込む筆記ボックスの矩形を受け取るポインタである。

解説(Remarks)

書き込みボックスは、描画ボックス (タブレットの画面上に物理的に描画され、その内側にユーザーが文字を書く線) の外側に書いてしまったユーザーに対して、誤差の余裕を提供します。描画ボックスを設定するには、DrawnBox プロパティを使用します。

vtbl 8 HRESULT put_WritingBox(IInkRectangle* Rectangle)

認識ガイドのうち、実際に書き込みを行える不可視の書き込み領域を取得または設定します。(Put)

RectangleIInkRectangle*inoptionalユーザーが書き込む筆記ボックスの矩形を指定するポインタである。

解説(Remarks)

書き込みボックスは、描画ボックス (タブレットの画面上に物理的に描画され、その内側にユーザーが文字を書く線) の外側に書いてしまったユーザーに対して、誤差の余裕を提供します。描画ボックスを設定するには、DrawnBox プロパティを使用します。

vtbl 9 HRESULT get_DrawnBox(IInkRectangle** Rectangle)

タブレットの画面上に物理的に描画され、その中で書き込みが行われるボックスを取得または設定します。(Get)

RectangleIInkRectangle**out画面に描画されるガイド ボックスの矩形を受け取るポインタである。

解説(Remarks)

描画ボックスの線は、書き込みが可能な場所を示す視覚的な手がかりです。通常、ユーザーはこの線の境界内に文字を書きます。

もう一方のボックスである書き込みボックスは、実際に書き込みを行える不可視のボックスです。描画ボックスよりも大きく、ユーザーが描画ボックスの線の外側にインクを描いた場合に備えて誤差の余裕を提供します。書き込みボックスを設定するには、WritingBox プロパティを使用します。

書き込みボックスは、認識エンジンに対してインクの境界を指定します。描画ボックスは、書き込みボックスの左上を基準としたインク空間 (ink space) 単位で描画されます。

vtbl 10 HRESULT put_DrawnBox(IInkRectangle* Rectangle)

タブレットの画面上に物理的に描画され、その中で書き込みが行われるボックスを取得または設定します。(Put)

RectangleIInkRectangle*inoptional画面に描画されるガイド ボックスの矩形を指定するポインタである。

解説(Remarks)

描画ボックスの線は、書き込みが可能な場所を示す視覚的な手がかりです。通常、ユーザーはこの線の境界内に文字を書きます。

もう一方のボックスである書き込みボックスは、実際に書き込みを行える不可視のボックスです。描画ボックスよりも大きく、ユーザーが描画ボックスの線の外側にインクを描いた場合に備えて誤差の余裕を提供します。書き込みボックスを設定するには、WritingBox プロパティを使用します。

書き込みボックスは、認識エンジンに対してインクの境界を指定します。描画ボックスは、書き込みボックスの左上を基準としたインク空間 (ink space) 単位で描画されます。

vtbl 11 HRESULT get_Rows(INT* Units)

認識ガイドの行数を取得または設定します。(Get)

UnitsINT*outガイドの行数を受け取るポインタである。

解説(Remarks)

行の高さは描画ボックスのサイズによって決まります。描画ボックスを取得または設定するには、DrawnBox プロパティを使用します。

使用する認識入力の種類は、Columns プロパティと Rows プロパティの値で制御します。Columns プロパティと Rows プロパティがどちらも 0 より大きい場合は、ボックス入力が使用されます。次の表に、指定できる入力モードと、各モードで Columns プロパティおよび Rows プロパティに設定する値を示します。

この種類の入力の場合 Rows に設定する値 Columns に設定する値
自由入力 0 0
1 本の線による縦罫線入力 0 1
n 本の線による縦罫線入力 0 n
1 本の線による横罫線入力 1 0
n 本の線による横罫線入力 n 0
1 個のボックスによるボックス入力 1 1
n 個のボックスを横一列に並べたボックス入力 n 1
x 行 y 列のボックスのグリッドによるボックス入力 x z
vtbl 12 HRESULT put_Rows(INT Units)

認識ガイドの行数を取得または設定します。(Put)

UnitsINTinガイドの行数を指定する。

解説(Remarks)

行の高さは描画ボックスのサイズによって決まります。描画ボックスを取得または設定するには、DrawnBox プロパティを使用します。

使用する認識入力の種類は、Columns プロパティと Rows プロパティの値で制御します。Columns プロパティと Rows プロパティがどちらも 0 より大きい場合は、ボックス入力が使用されます。次の表に、指定できる入力モードと、各モードで Columns プロパティおよび Rows プロパティに設定する値を示します。

この種類の入力の場合 Rows に設定する値 Columns に設定する値
自由入力 0 0
1 本の線による縦罫線入力 0 1
n 本の線による縦罫線入力 0 n
1 本の線による横罫線入力 1 0
n 本の線による横罫線入力 n 0
1 個のボックスによるボックス入力 1 1
n 個のボックスを横一列に並べたボックス入力 n 1
x 行 y 列のボックスのグリッドによるボックス入力 x z
vtbl 13 HRESULT get_Columns(INT* Units)

認識ガイドボックスの列数を取得または設定します。(Get)

UnitsINT*outガイドの列数を受け取るポインタである。

解説(Remarks)

列の幅は描画ボックスのサイズによって決まります。描画ボックスを取得または設定するには、DrawnBox プロパティを使用します。

使用する認識入力の種類は、Columns と Rows の値で制御します。Columns と Rows がどちらも 0 より大きい場合は、ボックス入力が使用されます。次の表に、指定できる入力モードと、各モードで Columns プロパティおよび Rows プロパティに設定する値を示します。

この種類の入力の場合 Rows プロパティに設定する値 Columns プロパティに設定する値
自由入力 0 0
1 本の線による縦罫線入力 0 1
n 本の線による縦罫線入力 0 n
1 本の線による横罫線入力 1 0
n 本の線による横罫線入力 n 0
1 個のボックスによるボックス入力 1 1
n 個のボックスを横一列に並べたボックス入力 n 1
x 行 z 列のボックスのグリッドによるボックス入力 x z
vtbl 14 HRESULT put_Columns(INT Units)

認識ガイドボックスの列数を取得または設定します。(Put)

UnitsINTinガイドの列数を指定する。

解説(Remarks)

列の幅は描画ボックスのサイズによって決まります。描画ボックスを取得または設定するには、DrawnBox プロパティを使用します。

使用する認識入力の種類は、Columns と Rows の値で制御します。Columns と Rows がどちらも 0 より大きい場合は、ボックス入力が使用されます。次の表に、指定できる入力モードと、各モードで Columns プロパティおよび Rows プロパティに設定する値を示します。

この種類の入力の場合 Rows プロパティに設定する値 Columns プロパティに設定する値
自由入力 0 0
1 本の線による縦罫線入力 0 1
n 本の線による縦罫線入力 0 n
1 本の線による横罫線入力 1 0
n 本の線による横罫線入力 n 0
1 個のボックスによるボックス入力 1 1
n 個のボックスを横一列に並べたボックス入力 n 1
x 行 z 列のボックスのグリッドによるボックス入力 x z
vtbl 15 HRESULT get_Midline(INT* Units)

ミッドラインの高さを取得または設定します。ミッドラインの高さとは、描画ボックスのベースラインからミッドラインまでの距離です。(Get)

UnitsINT*outセル内のミッドライン(中線)位置を受け取るポインタである。

解説(Remarks)

ミッドラインが存在しない場合、値は 0 になります。

vtbl 16 HRESULT put_Midline(INT Units)

ミッドラインの高さを取得または設定します。ミッドラインの高さとは、描画ボックスのベースラインからミッドラインまでの距離です。(Put)

UnitsINTinセル内のミッドライン(中線)位置を指定する。

解説(Remarks)

ミッドラインが存在しない場合、値は 0 になります。

vtbl 17 HRESULT get_GuideData(InkRecoGuide* pRecoGuide)

認識エンジンに対するインクの境界を表す InkRecoGuide 構造体を取得または設定します。(Get)

pRecoGuideInkRecoGuide*outガイドの全設定をまとめた InkRecoGuide 構造体を受け取るポインタである。
vtbl 18 HRESULT put_GuideData(InkRecoGuide recoGuide)

認識エンジンに対するインクの境界を表す InkRecoGuide 構造体を取得または設定します。(Put)

recoGuideInkRecoGuideinガイドの全設定をまとめた InkRecoGuide 構造体である。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IInkRecognizerGuide "{D934BE07-7B84-4208-9136-83C20994E905}"
#usecom global IInkRecognizerGuide IID_IInkRecognizerGuide "{8770D941-A63A-4671-A375-2855A18EBA73}"
#comfunc global IInkRecognizerGuide_get_WritingBox  7 sptr
#comfunc global IInkRecognizerGuide_put_WritingBox  8 sptr
#comfunc global IInkRecognizerGuide_get_DrawnBox    9 sptr
#comfunc global IInkRecognizerGuide_put_DrawnBox    10 sptr
#comfunc global IInkRecognizerGuide_get_Rows        11 var
#comfunc global IInkRecognizerGuide_put_Rows        12 int
#comfunc global IInkRecognizerGuide_get_Columns     13 var
#comfunc global IInkRecognizerGuide_put_Columns     14 int
#comfunc global IInkRecognizerGuide_get_Midline     15 var
#comfunc global IInkRecognizerGuide_put_Midline     16 int
#comfunc global IInkRecognizerGuide_get_GuideData   17 var
#comfunc global IInkRecognizerGuide_put_GuideData   18 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。