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

  • [アーティクル]

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

構文

HRESULT SetPacketValuesByProperty(
  [in]           BSTR    bstrPropertyName,
  [in]           VARIANT PacketValues,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  long    *NumberOfPacketsSet
);

パラメーター

[in] bstrPropertyName

設定するパケット データを選択するために使用される PacketProperty 定数からのグローバル一意識別子 (GUID) 識別子。 PacketDescription を使用して、このストロークの定義済みプロパティを決定します。

[in] PacketValues

パケット データ値の配列。 配列内のいずれかの値が プロパティの最小値または最大値の範囲外の場合、メソッドは失敗します。 プロパティ内の値の範囲を確認するには、 GetPacketDescriptionPropertyMetrics メソッドを 呼び出します。

[in, optional] Index

省略可能。 変更するパケットの開始インデックス。 ItemSelectionConstants 列挙型で定義されているISC_FirstElement既定値は、最初のパケットを指定します。

[in, optional] Count

省略可能。 変更するストローク内のパケット数と PacketValues の値の数を指定します。 ItemSelectionConstants 列挙型で定義されているISC_AllElements既定値は、すべてのパケットが変更されることを指定します。

[out, retval] NumberOfPacketsSet

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

戻り値

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

リターン コード 説明
S_OK
 正常終了しました。
E_POINTER
 パラメーターに無効なポインターが含まれていました。
CO_E_CLASSSTRING
 GUID 形式が無効です。
E_INVALIDARG
 バリアント、インデックス (範囲外)、またはプロパティ GUID が無効です。
E_INK_EXCEPTION
 メソッド内で例外が発生しました。

要件

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

こちらもご覧ください

GetPacketDescriptionPropertyMetrics メソッド

IInkStrokeDisp インターフェイス

ItemSelectionConstants 列挙

PacketPropertyGuids 定数