Evento InkPicture.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]

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

Un pacchetto in aria viene creato quando un utente sposta una penna vicino al tablet e il cursore si trova all'interno della finestra dell'agente di raccolta input penna o l'utente sposta un mouse all'interno della finestra associata dell'oggetto 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 nelle interfacce _IInkCollectorEvents, _IInkOverlayEvents e _IInkPictureEvents interfacce di sola distribuzione (dispinterfaces) con UN ID di DISPID_ICENewInAirPackets.

L'evento NewInAirPackets viene generato anche in modalità di selezione o cancellazione, non solo quando si inserisce l'input penna. Ciò richiede di monitorare la modalità di modifica (responsabile dell'impostazione) e di essere a conoscenza della 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, utilizzare la proprietà DesiredPacketDescription dell'oggetto agente di raccolta input penna. La matrice restituita dal parametro PacketData contiene i dati per tali proprietà.

Nota

Sebbene sia possibile modificare i dati del pacchetto, queste modifiche non vengono rese persistenti 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

Inkpicture

DesiredPacketDescription, proprietà

NewPackets, evento

Interfaccia IInkCursor