InkPicture.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 [in, out]
-
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 verschiebt und sich der Cursor im Fenster des Freihandsammlerobjekts befindet oder der Benutzer eine Maus innerhalb des zugeordneten Fensters des Freihandsammlerobjekts bewegt. NewInAirPackets-Ereignisse werden schnell generiert, und der Ereignishandler muss schnell sein, da sonst die Leistung beeinträchtigt wird.
Diese Ereignismethode ist 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 Freihandeingaben. Dies erfordert, dass Sie den Bearbeitungsmodus (für den Sie verantwortlich sind) überwachen und den Modus vor der Interpretation des Ereignisses beachten. 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 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 |
|