InkCollector.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]
-
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 |
|
| Bibliothek |
|