Evento InkCollector.NewInAirPackets

  • Articolo

Si verifica quando viene visualizzato un pacchetto in aria.

Sintassi

void NewInAirPackets(
  [in]      IInkCursor *Cursor,
  [in]      long       PacketCount,
  [in, out] VARIANT    *PacketData
);

Parametri

Cursore [in]

Oggetto IInkCursor che ha generato l'evento NewInAirPackets .

PacketCount [in]

Numero di pacchetti in aria ricevuti.

PacketData [in, out]

Quando questo metodo restituisce, contiene una matrice che contiene i dati selezionati per il pacchetto.

Per altre informazioni sulla struttura VARIANT, vedere Uso della libreria COM.

Valore restituito

Questo evento non restituisce un valore.

Commenti

Viene creato un pacchetto in aria quando un utente sposta una penna vicino al tablet e il cursore si trova nella finestra dell'agente di raccolta input penna o l'utente sposta un mouse all'interno della finestra associata dell'agente di raccolta input penna. Gli eventi NewInAirPackets vengono generati rapidamente e il gestore eventi deve essere veloce o le prestazioni soffrono.

Questo metodo di evento viene definito nella _IInkCollectorEvents, _IInkOverlayEvents e _IInkPictureEvents interfacce di sola distribuzione (dispinterfaces) con un ID di DISPID_ICENewInAirPackets.

L'evento NewInAirPackets viene attivato anche quando si seleziona o si cancella la modalità, non solo quando si inserisce l'input penna. Ciò richiede di monitorare la modalità di modifica (che è responsabile dell'impostazione) e tenere presente la modalità prima di interpretare l'evento. Il vantaggio di questo requisito è una maggiore libertà di innovazione sulla piattaforma attraverso una maggiore consapevolezza degli eventi della piattaforma.

Per impostare le proprietà contenute in questa matrice, usare la proprietà DesiredPacketDescription dell'oggetto agente di raccolta input penna. La matrice restituita dal parametro PacketData contiene i dati per tali proprietà.

Nota

Anche se è possibile modificare i dati del pacchetto, queste modifiche non vengono mantenute o usate.

Requisiti

Requisito Valore
Client minimo supportato
 Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato
 Nessuno supportato
Intestazione
Msinkaut.h (richiede anche Msinkaut_i.c)
Libreria
InkObj.dll

Vedi anche

Classe InkCollector

DesiredPacketDescription, proprietà

Evento NewPackets

Interfaccia IInkCursor