InkDisp クラス

[アーティクル]
06/13/2023

インク空間内のインクの収集されたストロークを表します。

InkDisp には、次の種類のメンバーがあります。

イベント
インターフェイス
メソッド
プロパティ

イベント

InkDisp クラスには、これらのイベントがあります。

Event	説明
InkAdded	ストロークが InkDisp オブジェクトに追加されたときに発生します。
InkDeleted	InkDisp オブジェクトからストロークが削除されたときに発生します。

インターフェイス

InkDisp クラスは、これらのインターフェイスを定義します。

インターフェイス	説明
IInkDisp	このオブジェクトは、 IInkDisp COM インターフェイスを実装します。

メソッド

InkDisp クラスには、これらのメソッドがあります。

メソッド	説明
AddStrokesAtRectangle	指定した四角形の InkDisp オブジェクトにストロークコレクションを挿入します。
Canpaste	IDataObject を InkDisp オブジェクトに変換できるかどうかを示します。
Clip	四角形の外側にあるストロークまたはストロークのコレクションの一部を削除します。
ClipboardCopy	InkStrokes コレクションをクリップボードにコピーします。
ClipboardCopyWithRectangle	既知の四角形内に含まれる IInkStrokeDisp オブジェクトをクリップボードにコピーします。
ClipboardPaste	クリップボードから InkDisp オブジェクトに IDataObject をコピーします。
クローン	重複する InkDisp オブジェクトを作成します。
CreateStroke	ポイントまたはパケットデータからストロークを作成します。
CreateStrokes	この InkDisp オブジェクトの InkStrokes コレクションを作成します。
DeleteStroke	InkDisp オブジェクトからストロークを削除します。
DeleteStrokes	InkDisp オブジェクトからストロークを削除します。
ExtractStrokes メソッド	InkDisp オブジェクトからストロークを抽出し、抽出されたストロークを含む新しい InkDisp オブジェクトを返します。
ExtractWithRectangle メソッド	既存の InkDisp Class オブジェクトからストロークを切り取るかコピーし、既知の四角形を使用して抽出するストロークを決定することで、新しい InkDisp クラスオブジェクトに貼り付けます。
GetBoundingBox	InkDisp オブジェクト内のすべてのストロークの境界ボックスを取得します。
HitTestCircle	既知の円の内側または交差する InkStrokes コレクションを取得します。
HitTestWithLasso	ポリライン選択領域内のストロークを取得します。
HitTestWithRectangle	指定した四角形内に含まれるストロークを取得します。
[読み込み]	新しい InkDisp オブジェクトに既知のバイナリデータを設定します。
NearestPoint	既知のポイントに最も近い InkDisp オブジェクト内の IInkStrokeDisp を取得し、必要に応じて追加情報を提供します。
保存	インクを指定した形式に変換し、バイナリデータを返します。

プロパティ

InkDisp クラスには、これらのプロパティがあります。

プロパティ	アクセスの種類	説明
CustomStrokes	読み取り専用	インクで永続化する IInkCustomStrokes コレクションを取得します。
汚い	読み取り/書き込み	インクが最後に保存されてから InkDisp オブジェクトが変更されたかどうかを示す値を取得または設定します。
ExtendedProperties	読み取り専用	アプリケーション定義データのコレクションを取得します。
線	読み取り専用	InkDisp オブジェクトに含まれる InkStrokes コレクションを取得します。

解説

このオブジェクトは、C++ で CoCreateInstance メソッドを呼び出すことによってインスタンス化できます。

注意

このオブジェクトの最初のインスタンス化により、GDI+ もインスタンス化されます。副作用は、ループ内で 1 つのインクオブジェクトを使用し、ループ内で作成して破棄すると、GDI+ が何度もインスタンス化されることです。これにより、アプリケーションのパフォーマンスが低下する可能性があります。これを防ぐには、アプリケーションでインクを使用している間は、インクオブジェクトの 1 つのインスタンスを常に保持します。

InkDisp オブジェクトは、ストローク (ポイント) データのコンテナーです。ストロークデータ、またはペンによって収集されたポイントは、 InkDisp オブジェクトに格納されます。 Strokes プロパティには、InkDisp オブジェクト内のすべてのストロークのデータが含まれます。

InkCollector オブジェクト、InkOverlay オブジェクト、InkPicture コントロールは、入力デバイスからポイントを収集し、InkDisp オブジェクトに配置します。これらのオブジェクトは基本的に、インクを 1 つまたは複数の異なる InkDisp オブジェクトに配布するソースとして機能します。これは、分散インクを保持するコンテナーとして機能します。

インク空間は、タブレットコンテキストの座標がマップされる仮想座標空間です。この空間は HIMETRIC 座標系に固定されます。インク空間座標では、0 から 1 への移動は 1 HIMETRIC 単位と等しくなります。このマッピングにより、複数の InkDisp オブジェクトを簡単に関連付けることができます。

InkRenderer オブジェクトは、インクと表示ウィンドウの間のマッピングを管理します。

必要条件

要件	値
サポートされている最小のクライアント	Windows XP Tablet PC Edition [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
Header	Msinkaut.h (Msinkaut_i.c も必要)
ライブラリ	InkObj.dll