Evento InkCollector.NewInAirPackets
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 |
|
| Libreria |
|