InkCollector.NewInAirPackets イベント

空中パケットが見られると発生します。

構文

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

パラメーター

Cursor [in]

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

PacketCount [in]

受信したエア内パケットの数。

PacketData [in, out]

このメソッドが返されるときに、 には、パケットの選択したデータを含む配列が含まれます。

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

戻り値

このイベントは値を返しません。

解説

ユーザーがタブレットの近くにペンを移動し、カーソルがインク コレクター オブジェクトのウィンドウ内にある場合、またはユーザーがインク コレクター オブジェクトの関連付けられたウィンドウ内でマウスを移動すると、エア内パケットが作成されます。 NewInAirPackets イベントは迅速に生成され、イベント ハンドラーは高速であるか、パフォーマンスが低下する必要があります。

このイベント メソッドは、DISPID_ICENewInAirPacketsの ID を持つディスパッチ専用インターフェイス (ディスパッチインターフェイス) _IInkCollectorEvents、_IInkOverlayEvents、および_IInkPictureEventsで定義されます。

インクの挿入時だけでなく、選択モードまたは消去モードでも NewInAirPackets イベントが発生します。 これには、編集モード (設定を担当する) を監視し、イベントを解釈する前にモードに注意する必要があります。 この要件の利点は、プラットフォーム イベントの認識を高めることによって、プラットフォーム上でイノベーションを行う自由が増すことです。

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

注意

パケット データは変更できますが、これらの変更は永続化も使用もされません。

必要条件

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

関連項目

InkCollector クラス

DesiredPacketDescription プロパティ

NewPackets イベント

IInkCursor インターフェイス