ホーム › UI.TabletPC › IInkDivisionUnit

IInkDivisionUnit

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IID85aee342-48b0-4244-9dd5-1ed435410fab継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

IInkDivisionResult オブジェクト内の 1 つの構造要素を表します。

解説(Remarks)

Item メソッドを使用すると、DivisionUnits コレクションから 1 つの要素を取得できます。

このインターフェイスを実装するクラスを独自に定義した場合、その新しいクラスは Tablet PC のアプリケーションプログラミングインターフェイス (API) と正しく連携しません。

メソッド 4

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

vtbl 7 HRESULT get_Strokes(IInkStrokes** Strokes)

オブジェクトに含まれるストローク、またはオブジェクトの作成に使用されたストロークのコレクションを取得します。(IInkDivisionUnit.get_Strokes)

Strokes

IInkStrokes**

out

この分割単位に含まれるストロークコレクションを受け取るポインタである。

解説(Remarks)

このストロークのコレクションは、InkDisp オブジェクトに含まれるストロークのコピーである場合と、そのオブジェクトまたはコレクションの作成に使用されたストロークである場合があります。

メモ InkDisp オブジェクトの Strokes プロパティは、InkDisp オブジェクトが実際に扱っているコレクションではなく、そのコピーを返します。つまり、このコレクションに対してストロークを追加または削除しても、InkDisp オブジェクトのストロークには影響しません。ストロークを追加または削除するには、AddStrokesAtRectangle、DeleteStroke、DeleteStrokes などの InkDisp のメソッドを使用してください。ただし、コレクション内の各ストロークは、元の IInkStrokeDisp オブジェクトへの参照です。

vtbl 8 HRESULT get_DivisionType(InkDivisionType* divisionType)

解析結果の中で IInkDivisionUnit オブジェクトが表す構造単位の種類を取得します。

divisionType

InkDivisionType*

out

この分割単位の種類(セグメント・行・段落・描画)を受け取る InkDivisionType へのポインタである。

vtbl 9 HRESULT get_RecognizedString(LPWSTR* RecoString)

RecoString

LPWSTR*

out

この分割単位の認識文字列を受け取るポインタである。

vtbl 10 HRESULT get_RotationTransform(IInkTransform** RotationTransform)

IInkDivisionUnit オブジェクトがストロークを水平に回転させるために使用する変換行列を取得します。

RotationTransform

IInkTransform**

out

この分割単位の回転を表す変換オブジェクトを受け取るポインタである。

解説(Remarks)

テキストの認識エンジンは、手書き文字が水平である場合に最も高い性能を発揮します。ストロークを InkRecognizerContext オブジェクトに渡す前に、IInkDivisionUnit オブジェクトの Strokes プロパティにこの変換を適用してください。

メモ段落または描画を表す IInkDivisionUnit オブジェクトの場合、このプロパティは NULL を返します。

このプロパティは、手書き文字の傾きを補正する場合や、傾いた手書き文字の周囲に線や図形を正確に描画する場合に使用します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IInkDivisionUnit "{85AEE342-48B0-4244-9DD5-1ED435410FAB}"
#usecom global IInkDivisionUnit IID_IInkDivisionUnit "{}"
#comfunc global IInkDivisionUnit_get_Strokes            7 sptr
#comfunc global IInkDivisionUnit_get_DivisionType       8 var
#comfunc global IInkDivisionUnit_get_RecognizedString   9 var
#comfunc global IInkDivisionUnit_get_RotationTransform  10 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IInkDivisionUnit "{85AEE342-48B0-4244-9DD5-1ED435410FAB}"
#usecom global IInkDivisionUnit IID_IInkDivisionUnit "{}"
#comfunc global IInkDivisionUnit_get_Strokes            7 sptr
#comfunc global IInkDivisionUnit_get_DivisionType       8 sptr
#comfunc global IInkDivisionUnit_get_RecognizedString   9 sptr
#comfunc global IInkDivisionUnit_get_RotationTransform  10 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。