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	Msinkaut.h (erfordert auch Msinkaut_i.c)
Bibliothek	InkObj.dll

Weitere Informationen

Inkpicture

DesiredPacketDescription-Eigenschaft

NewPackets-Ereignis

IInkCursor-Schnittstelle