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

[アーティクル]
03/05/2024

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 が含まれています。

要件

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