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

IInkStrokeDisp オブジェクト内のパケットの範囲のパケットデータを取得します。

構文

HRESULT GetPacketData(
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketData
);

パラメーター

[in, optional] Index

オプション。ストローク内のパケットに対する 0 から始まるインデックスの開始点。 InkSelectionConstants 列挙型で定義ISC_FirstElement既定値は、最初のパケットを指定します。

[in, optional] Count

オプション。 startingIndex パラメーターで指定されたパケットから始まる、返されるポイントパケットデータセットの数。 InkSelectionConstants 列挙型で定義ISC_AllElements既定値は、ストロークデータを構成するすべてのポイントを指定します。

[out, retval] PacketData

このメソッドから制御が戻るときに、ストローク内の要求されたポイントのパケットデータを含む符号付き 32 ビット整数配列が格納されます。配列には、最初のポイントのデータ、次に 2 番目のポイントのデータなどが含まれます。

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

値を返す

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

リターンコード	説明
S_OK	成功しました。
E_POINTER	パラメーターに無効なポインターが含まれていました。
E_FAIL	指定されていないエラーが発生しました。
E_OUTOFMEMORY	Stroke ハンドラーヘルパーオブジェクトを割り当てることができません。
E_INVALIDARG	ストロークが無効です。
E_INK_EXCEPTION	メソッド内で例外が発生しました。
E_UNEXPECTED	予期しないパラメーターまたはプロパティの型。

注釈

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

パケットデータの説明を取得するには、ストロークの PacketDescription プロパティを使用します。このプロパティは、各ポイントの GetPacketData メソッドによって返されるプロパティ値を示すグローバル一意識別子 (GUID) の配列を返します。 PacketProperty 定数には、使用可能なパケットプロパティ GUID が含まれています。

必要条件

Requirement	価値
サポートされる最小クライアント	Windows XP タブレット PC エディション [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
ターゲットプラットフォームの	Windows
ヘッダー	msinkaut.h