InkCollector.NewPackets-Ereignis

Artikel
06/13/2023

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]

Gibt das IInkStrokeDisp-Objekt an.

PacketCount [in]

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

PacketData [in, out]

Wenn diese Methode zurückgibt, enthält 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, da sonst die Leistung beeinträchtigt wird.

TDiese 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 Array, das vom PacketData-Parameter zurückgegeben wird, 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

Siehe auch

InkCollector-Klasse
NewInAirPackets-Ereignis
IInkCursor-Schnittstelle
IInkStrokeDisp-Schnittstelle

Freigeben über