InkDisp クラス
インク空間内のインクの収集されたストロークを表します。
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 |
|
| ライブラリ |
|