InkPicture.NewInAirPackets-Ereignis

Tritt ein, wenn ein Paket in der Luft gesehen 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.

Hinweise

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 Freiformsammlerobjekts befindet oder der Benutzer eine Maus im zugeordneten Fenster des Freiformsammlerobjekts bewegt. NewInAirPackets-Ereignisse werden schnell generiert, und der Ereignishandler muss schnell sein oder die Leistung beeinträchtigen.

Diese Ereignismethode wird in den Dispatch-Schnittstellen _ IInkCollectorEvents, _ IInkOverlayEvents und _ IInkPictureEvents (dispinterfaces) mit der ID DISPID _ ICENewInAirPackets definiert.

Das NewInAirPackets-Ereignis wird auch dann ausgelöst, wenn es sich im Auswahl- oder Löschmodus befindet, nicht nur beim Einfügen von Ink. 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 Innovationsfähigkeit auf der Plattform durch ein größeres Bewusstsein für Plattformereignisse.

Verwenden Sie zum Festlegen der in diesem Array enthaltenen Eigenschaften die DesiredPacketDescription-Eigenschaft des Ink-Collectorobjekts. Das Array, das der PacketData-Parameter zurückgibt, 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 Nur Desktop-Apps der XP Tablet PC Edition []
Unterstützte Mindestversion (Server)
Nicht unterstützt
Header
Msinkaut.h (erfordert auch Msinkaut _ i.c)
Bibliothek
InkObj.dll

Siehe auch

Inkpicture

DesiredPacketDescription-Eigenschaft

NewPackets-Ereignis

IInkCursor-Schnittstelle