InkOverlay.NewPackets イベント

インク コレクターがパケットを受信したときに発生します

構文

void NewPackets(
  [in]      IInkCursor     *Cursor,
  [in]      IInkStrokeDisp *Stroke,
  [in]      long           PacketCount,
  [in, out] VARIANT        *PacketData
);

パラメーター

Cursor [in]

NewInAirPackets イベントを生成した IInkCursor オブジェクト。

Stroke [in]

IInkStrokeDisp オブジェクトを指定します。

PacketCount [in]

IInkStrokeDisp オブジェクトに対して受信したパケットの数。

PacketData [in、out]

パケットに対して選択されたデータを含む配列。

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

戻り値

このイベントでは値は返されません。

解説

パケットは、ストロークが収集されている間に受信されます。 パケット イベントは急に発生するので、NewPackets イベント ハンドラーは高速でなければならず、そうでないとパフォーマンスが低下します。

このイベント メソッドは、_IInkCollectorEvents、_IInkOverlayEvents、_IInkPictureEvents の各ディスパッチ専用インターフェイス (dispinterface) において、DISPID_ICENewPackets という ID で定義されています。

このイベントは、イベント ハンドラー内で実行されるコードが多すぎると、インクのパフォーマンスに悪影響を及ぼす可能性があるため、慎重に使う必要があります。

この配列に含まれるプロパティを設定するには、インク コレクター オブジェクトの DesiredPacketDescription プロパティを使います。 PacketData パラメーターが返す配列には、それらのプロパティのデータが含まれています。

Note

パケットのデータを変更してもかまいませんが、これらの変更は永続化も使用もされません。

要件

要件	Value
サポートされている最小のクライアント	Windows XP タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
ヘッダー	Msinkaut.h (Msinkaut_i.c も必要)
ライブラリ	InkObj.dll

関連項目

InkOverlay クラス

NewInAirPackets イベント

IInkCursor インターフェイス

IInkStrokeDisp インターフェイス