IInkStrokeDisp::SetPoints メソッド (msinkaut.h)

X、Y 値の配列を使用して 、IInkStrokeDisp のポイントを設定します。

構文

HRESULT SetPoints(
  [in]           VARIANT Points,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  long    *NumberOfPointsSet
);

パラメーター

[in] Points

インデックスから始まるストローク内のポイントを置き換える新しいポイントの配列。 これは、フォーム x0、y0、x1、y1、x2、y2 などの交互の値で表されるポイントを持つ Long の配列を含む VARIANT です。

VARIANT 構造の詳細については、「 COM ライブラリの使用」を参照してください。

[in, optional] Index

オプション。 変更するストロークの最初のポイントの 0 から始まるインデックス。 ItemSelectionConstants 列挙型で定義ISC_FirstElement既定値は、ストロークの最初のポイントが変更されることを指定します。

[in, optional] Count

オプション。 変更するストローク内のポイントの数。 ItemSelectionConstants 列挙型で定義ISC_AllElements既定値は、ストローク内のすべてのポイントが変更されることを指定します。

[out, retval] NumberOfPointsSet

このメソッドから制御が戻るときに、実際に設定されたパケット数が格納されます。

値を返す

このメソッドは、これらの値のいずれかを返すことができます。

注釈

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

このメソッドは、ストロークの切り捨てを提供しません。 points 配列に含まれるポイント数がストロークよりも少ない場合、ストローク内の残りのポイントは変更されません。

このメソッドでは、ストロークを拡張することはできません。 points 配列にストロークよりも多くのポイントが含まれている場合、余分なポイントは使用されません。 カウントが配列内のポイント数を超える場合、配列内のポイント数のみが変更されます。

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

必要条件

こちらも参照ください

IInkStrokeDisp インターフェイス

ItemSelectionConstants 列挙型