InkPicture.NewPackets-Ereignis

Tritt auf, wenn der Freihandsammler ein Paket empfängt.

Syntax

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

Parameter

Cursor [in]

Das IInkCursor-Objekt , das das NewInAirPackets-Ereignis generiert hat .

Strich [in]

Das IInkStrokeDisp-Objekt .

PacketCount [in]

Die Anzahl der Pakete, die für ein IInkStrokeDisp-Objekt empfangen werden.

PacketData [ein, aus]

Ein Array, das die ausgewählten Daten für das Paket enthält.

Weitere Informationen zur VARIANT-Struktur finden Sie unter Verwenden der COM-Bibliothek.

Rückgabewert

Dieses Ereignis gibt keinen Wert zurück.

Bemerkungen

Pakete werden empfangen, während ein Strich erfasst wird. Paketereignisse treten schnell auf, und ein NewPackets-Ereignishandler muss schnell sein, sonst leidet die Leistung.

Diese Ereignismethode wird in den _IInkCollectorEvents-, _IInkOverlayEvents- und _IInkPictureEvents Dispatch-only-Schnittstellen (dispinterfaces) mit der ID DISPID_ICENewPackets definiert.

Dieses Ereignis sollte sorgfältig verwendet werden, da es sich negativ auf die Freihandleistung auswirken kann, wenn zu viel Code in den Ereignishandlern ausgeführt wird.

Um festzulegen, welche Eigenschaften in diesem Array enthalten sind, verwenden Sie die DesiredPacketDescription-Eigenschaft des Freihandsammlerobjekts. Das Vom PacketData-Parameter zurückgegebene Array enthält die Daten für diese Eigenschaften.

Hinweis

Obwohl Sie die Paketdaten ändern können, werden diese Änderungen nicht beibehalten oder verwendet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Nicht unterstützt
Header
msinkaut.h (erfordert auch Msinkaut_i.c)
Bibliothek
InkObj.dll

Weitere Informationen

Inkpicture

NewInAirPackets-Ereignis

IInkCursor-Schnittstelle

IInkStrokeDisp-Schnittstelle