InkCollector.NewInAirPackets-Ereignis
Tritt auf, wenn ein In-Air-Paket angezeigt wird.
Syntax
void NewInAirPackets(
[in] IInkCursor *Cursor,
[in] long PacketCount,
[in, out] VARIANT *PacketData
);
Parameter
-
Cursor [in]
-
Das IInkCursor-Objekt , das das NewInAirPackets-Ereignis generiert hat .
-
PacketCount [in]
-
Die Anzahl der empfangenen In-Air-Pakete.
-
PacketData [ein, aus]
-
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
Ein In-Air-Paket wird erstellt, wenn ein Benutzer einen Stift in die Nähe des Tablets bewegt und sich der Cursor im Fenster des Freihandsammlerobjekts befindet oder wenn der Benutzer eine Maus im zugeordneten Fenster des Freihandsammlerobjekts bewegt. NewInAirPackets-Ereignisse werden schnell generiert, und der Ereignishandler muss schnell sein, oder die Leistung leidet.
Diese Ereignismethode wird in den _IInkCollectorEvents-, _IInkOverlayEvents- und _IInkPictureEvents Dispatch-only-Schnittstellen (dispinterfaces) mit der ID DISPID_ICENewInAirPackets definiert.
Das NewInAirPackets-Ereignis wird auch im Auswahl- oder Löschmodus ausgelöst, nicht nur beim Einfügen von Freihand. Dies erfordert, dass Sie den Bearbeitungsmodus überwachen (den Sie festlegen müssen) und den Modus kennen, bevor Sie das Ereignis interpretieren. Der Vorteil dieser Anforderung ist eine größere Freiheit für Innovationen auf der Plattform durch ein größeres Bewusstsein für Plattformereignisse.
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 |
|
| Bibliothek |
|