IInkStrokeDisp

単一のインクストロークを表します。ストロークとは、特定のインクの筆跡の座標とプロパティを表す、デジタイザーが取得したプロパティとポイントデータの集合です。

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

オブジェクトの識別子を取得します。(IInkStrokeDisp.get_Id)

オブジェクトの識別子は変化しません。

ストロークのベジェ近似を表す制御点の配列を取得します。

BezierPoints プロパティが返す制御点は、元のストロークの滑らかな近似を提供するものであり、必ずしもストローク上に位置するとは限りません。

インクを描画する際に適用する描画属性を取得または設定します。(IInkStrokeDisp.get_DrawingAttributes)

描画属性は、ストロークの外観を指定します。たとえば、ペンのスタイルや色を指定できます。

カーソルは、接触する InkCollector ごとに異なる描画属性を持つことができます。カーソルに描画属性を指定しない場合は、InkCollector オブジェクトの既定の描画属性が使用されます。これらの既定属性は、InkCollector オブジェクトの DefaultDrawingAttributes プロパティで設定します。

DrawingAttributes プロパティを繰り返し呼び出しても、変更されるのは新しいストロークの描画属性だけです。すでに収集済みのストロークや収集中のストロークには適用されません。

ストロークの親となる InkDisp オブジェクトを取得します。

ストロークは、必ず 1 つの InkDisp オブジェクトにのみ含まれている必要があります。

オブジェクトに格納されている、アプリケーション定義データのコレクションを取得します。(IInkStrokeDisp.get_ExtendedProperties)

アプリケーションは ExtendedProperties プロパティを使用して、オブジェクトに格納されたカスタムデータにアクセスできます。このカスタムデータは、オブジェクトと共に自動的にシリアル化されます。

IInkStrokeDisp オブジェクトのカスプのインデックスを格納した配列を取得します。

PolylineCusps プロパティが返す配列は、GetPoints メソッドが返す配列へのインデックスです。PolylineCusps プロパティの各インデックスは、GetPoints メソッドが返す配列のうち、ストロークの点のカスプに当たる点に対応します。

カスプ (cusp) とは、筆記の方向が不連続に変化するストローク上の点です。たとえば、ストロークが大文字の「L」を表す場合、このプロパティは 3 つのカスプを返します。うち 2 つはストロークの最初と最後の制御点に対応し、3 つ目は「L」の角を表します。

カスプの位置は、そのカスプを GetPoints メソッドが返す配列へのインデックスとして使用することで求められます。

ストロークのベジェ近似におけるカスプのインデックスを格納した配列を取得します。

次のコードは、IInkStrokeDisp である theStroke のベジェカスプの x 値と y 値を抽出し、BezierCuspValues という 2 次元配列に格納します。

ストロークの自己交差点を取得します。

自己交差点とは、ストロークがそれ自身と交差する点のことです。

浮動小数点インデックスとは、ストローク内の 2 点の間のどこかの位置を表す浮動小数点値です。たとえば、0.0 がストロークの最初の点、1.0 が 2 番目の点を表す場合、0.5 は最初の点と 2 番目の点のちょうど中間を表します。同様に、37.25 という浮動小数点インデックス値は、ストロークの 37 番目の点と 38 番目の点を結ぶ線分上の 25 パーセントの位置を表します。

IInkStrokeDisp オブジェクトで受信したパケットの数を取得します。

パケットのサイズ (バイト単位) を取得します。

IInkStrokeDisp オブジェクトに格納されているパケットデータの種類を示す、グローバル一意識別子 (GUID) の配列を取得します。

利用できるパケットプロパティの完全な一覧については、PacketProperty 定数を参照してください。

特定のストロークがインクから削除されているかどうかを示す値を取得します。

InkDisp オブジェクト内のすべてのストローク、個々のストローク、または InkStrokes コレクションの境界ボックスを、インクスペース座標で取得します。(IInkStrokeDisp.GetBoundingBox)

このメソッドは、次のいずれかの値を返すことがあります。

境界ボックスがペン幅の影響を受ける場合、この幅は InkRenderer のビュー変換に合わせて拡大縮小されます。具体的には、ペン幅にビュー変換の行列式の平方根を乗じます。

この IInkStrokeDisp オブジェクトが、特定の InkStrokes コレクション内の他の IInkStrokeDisp オブジェクトと交差する点を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

このメソッドで判定できるのは交差点のみです。

IInkStrokeDisp オブジェクトが指定した矩形と交差する点を検出します。

このメソッドは、次のいずれかの値を返すことがあります。

このメソッドは、ストロークが指定した矩形と交差する位置を示す配列を返します。矩形と交差するストロークの各セグメントは、開始インデックスと終了インデックスが交互に並ぶ 1 組のインデックスとして表されます。

ストロークがテスト矩形の内側から始まる場合、最初のインデックスには -1 が設定されます。ストロークがテスト矩形の内側で終わる場合、最後のインデックスには -1 が設定されます。ストローク全体がテスト矩形の外側にある場合は、空の配列が返されます。たとえば、ストロークがテスト矩形の内側から始まり、矩形の境界を出て、再び内側に戻り、再度外に出る場合、GetRectangleIntersections メソッドは、矩形内に含まれる 2 つのセグメントを表す {-1, 1.4, 5.5, 10.1} のような値を返すことがあります。

IInkStrokeDisp オブジェクトまたは InkStrokes コレクションのうち、矩形の外側にある部分を削除します。(IInkStrokeDisp.Clip)

このメソッドは、次のいずれかの値を返すことがあります。

InkDisp オブジェクトの場合、矩形と交差するすべてのストロークは交差点で分割されます。矩形の外側にあるストロークの部分はすべて InkDisp オブジェクトから削除されます。このメソッドは、ストロークが矩形と交差する位置に新しい点を追加することがあります。InkDisp オブジェクトに対して Clip メソッドを呼び出した後、InkDisp オブジェクトのストロークコレクション内のストローク ID は一意であることが保証されますが、その他の情報が保持されることは保証されません。

このメソッドは、クリップ時にペン幅を考慮しません。クリップされるのは実際の インク またはストロークのデータのみです。

IInkStrokeDisp オブジェクトまたは InkStrokes コレクションの場合、Clip メソッドは親の InkDisp オブジェクトを更新します。InkDisp オブジェクトからインクが削除されると、その InkDisp オブジェクトに対して定義されている IInkStrokeDisp オブジェクトや InkStrokes コレクションが無効になることがあります。

インクデータの詳細については、「インクデータ」を参照してください。

ストロークが指定した円の内側に完全に含まれるか、またはその円と交差するかを判定します。

このメソッドは、次のいずれかの値を返すことがあります。

指定した点に最も近いストローク上の位置を検出し、その点からストロークまでの距離を返します。すべてインクスペース座標で扱います。

このメソッドは、次のいずれかの値を返すことがあります。

distance パラメーターは、点からストロークの外形までの距離を表します。これは、 2 点間の距離からストロークの幅の半分を引いた値です。

指定した位置でストロークを分割します。

このメソッドは、次のいずれかの値を返すことがあります。

このメソッドは、ストロークセット内の元のストロークの直後に新しいストロークを挿入し、以降のストロークインデックスを番号付け直します。

IInkStrokeDisp を分割すると、ストロークの前半部分は元の IInkStrokeDisp の ID をそのまま保持します。IInkStrokeDisp の後半部分は、既存の最大の IInkStrokeDisp ID より 1 大きい ID を持つ新しい IInkStrokeDisp になります。元の IInkStrokeDisp が (Ink.Strokes 以外の) InkStrokes コレクションに含まれていた場合、そのコレクションに残るのは前半部分のみです。

指定したパケット記述の種類に対するメトリックを取得します。

このメソッドは、次のいずれかの値を返すことがあります。

ストロークを構成する点を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

X、Y 値の配列を使用して IInkStrokeDisp の点を設定します。

このメソッドは、次のいずれかの値を返すことがあります。

このメソッドは、ストローク内の点の数を変更しません。ストローク内の点の数を変更するには、新しいストロークを作成するか、ストロークを分割する必要があります。

このメソッドではストロークを切り詰めることはできません。点の配列の要素数がストロークの点の数より少ない場合、ストロークの残りの点は変更されません。

このメソッドではストロークを拡張することもできません。点の配列の要素数がストロークの点の数より多い場合、余分な点は使用されません。カウントが配列内の点の数を超える場合は、配列内の点の数だけが変更されます。

SetPoints を呼び出した後にストロークを描画するには、InvalidateRect 関数を呼び出してください。

IInkStrokeDisp オブジェクト内の指定した範囲のパケットについて、パケットデータを取得します。

このメソッドは、次のいずれかの値を返すことがあります。

ストローク内のパケット数が startingIndex パラメーターと pointCount パラメーターの合計より少ない場合、返されるデータ配列には要求した数より少ない点のパケット情報が含まれます。

パケットデータの記述を取得するには、ストロークの PacketDescription プロパティを使用します。このプロパティは、GetPacketData メソッドが各点についてどのプロパティ値を返すかを示す、グローバル一意識別子 (GUID) の配列を返します。利用できるパケットプロパティの GUID は PacketProperty 定数に含まれています。

ストローク内の 1 つ以上のパケットから、指定したパケットプロパティのデータを取得します。

このメソッドは、次のいずれかの値を返すことがあります。

特定のパケットプロパティは、ある IInkStrokeDisp オブジェクトでは利用できない場合があります。Tablet PC には、ユーザー入力用のタブレットが複数接続されていることがあります。InkTablets コレクションには、Tablet PC に接続されているすべてのタブレットの一覧が含まれます。特定のパケットプロパティが、特定の IInkTablet オブジェクトで、または利用可能なすべてのタブレットでサポートされているかを判定するには、IsPacketPropertySupported メソッドを使用します。また、新しいストロークでどのパケットプロパティを収集するかを制御するには、インクコレクターの DesiredPacketDescription プロパティを使用します。

特定のプロパティのパケット値を変更します。

このメソッドは、次のいずれかの値を返すことがあります。

InkDisp オブジェクト内のすべてのストローク、個々のストローク、または InkStrokes コレクションの境界ボックスを、インクスペース座標で取得します。

このメソッドは、次のいずれかの値を返すことがあります。

fittingError パラメーターは、0 から 500 の範囲で設定するのが理想的です。値が 500 を超えると、描画時にストロークが歪んだり粗く見えたりすることがあります。フィッティング誤差レベルを 0 に設定するとストロークは最も滑らかになりますが、描画パフォーマンスは最も低下します。

IInkStrokeDisp オブジェクトまたは InkStrokes コレクションに線形変換を適用します。この変換には、拡大縮小、回転、平行移動、およびそれらの組み合わせを指定できます。(IInkStrokeDisp.Transform)

このメソッドは、次のいずれかの値を返すことがあります。

IInkStrokeDisp オブジェクトまたは InkStrokes コレクションを、指定した InkRectangle オブジェクトに収まるように拡大縮小します。(IInkStrokeDisp.ScaleToRectangle)

このメソッドは、次のいずれかの値を返すことがあります。

IInkStrokeDisp オブジェクトまたは InkStrokes コレクションのインクに平行移動を適用します。(IInkStrokeDisp.Move)

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

回転の中心点を基準に、指定した角度 (度単位) でインクを回転させます。(IInkStrokeDisp.Rotate)

このメソッドは、次のいずれかの値を返すことがあります。

指定した水平方向および垂直方向の係数で、ストロークのインクをせん断 (シア) させます。(IInkStrokeDisp.Shear)

このメソッドは、次のいずれかの値を返すことがあります。

このメソッドで適用される変換が純粋なせん断になるのは、いずれかのパラメーターが 0 の場合だけです。原点にある矩形に適用する場合、shearY 係数が 0 のとき、この変換は下辺を矩形の高さの shearX 倍だけ水平に移動させます。shearX 係数が 0 のときは、右辺を矩形の幅の shearY 倍だけ垂直に移動させます。

指定した水平方向および垂直方向の係数を、変換またはインクに適用します。(IInkStrokeDisp.ScaleTransform)

このメソッドは、次のいずれかの値を返すことがあります。

IInkStrokeDisp クラスおよび InkStrokes クラスの場合、このメソッドは原点を基準としてストローク内の点を拡大縮小します。したがって、HorizontalMultiplier パラメーターが 2.0 の場合、ストロークの幅は 2 倍になり、原点からの水平方向の距離も 2 倍になります。ストロークの相対位置を制御するには、このメソッドを Move メソッドと併用します。