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

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

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

構文

HRESULT GetPacketValuesByProperty(
  [in]           BSTR    PropertyName,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketValues
);

パラメーター

[in] PropertyName

取得するパケットデータを選択するために使用された PacketProperty 定数からの識別子。

BSTR データ型の詳細については、「 COM ライブラリの使用」を参照してください。

[in, optional] Index

省略可能。ストローク内のパケットへの 0 から始まるインデックスの開始点。 InkSelectionConstants 列挙型で定義されているISC_FirstElement既定値は、最初のパケットを指定します。

[in, optional] Count

省略可能。ストロークデータを構成するポイントの数。 InkSelectionConstants 列挙型で定義ISC_AllElements既定値は、ストロークデータを構成するすべてのポイントを指定します。

[out, retval] PacketValues

このメソッドが戻るとき、には、ストロークから要求された各ポイントの要求された PacketProperty の値を指定する符号付き 32 ビット整数の配列が含まれます。

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

戻り値

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

リターンコード	説明
S_OK	正常終了しました。
TPC_E_INVALID_STROKE	ストロークが無効です。
E_POINTER	パラメーターに無効なポインターが含まれていました。
E_FAIL	未指定のエラーが発生しました。
E_OUTOFMEMORY	パケットデータ配列を割り当てることができません。
E_INVALIDARG	インデックス、カウント、またはパケットプロパティが無効です。
E_INK_EXCEPTION	メソッド内で例外が発生しました。
CO_E_CLASSSTRING	GUID 形式が無効です。

注釈

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

要件

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