Evento InkCollector.NewPackets

  • Articolo

Si verifica quando l'agente di raccolta input penna riceve un pacchetto.

Sintassi

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

Parametri

Cursore [in]

Oggetto IInkCursor che ha generato l'evento NewInAirPackets .

Tratto [in]

Specifica l'oggetto IInkStrokeDisp .

PacketCount [in]

Numero di pacchetti ricevuti per un oggetto IInkStrokeDisp .

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

I pacchetti vengono ricevuti mentre viene raccolto un tratto. Gli eventi dei pacchetti si verificano rapidamente e un gestore eventi NewPackets deve essere veloce o le prestazioni soffrono.

Il metodo di evento TThis è definito nel _IInkCollectorEvents, _IInkOverlayEvents e _IInkPictureEvents interfacce di sola distribuzione (dispinterfaces) con un ID di DISPID_ICENewPackets.

Questo evento deve essere usato attentamente perché potrebbe avere un effetto negativo sulle prestazioni dell'input penna se viene eseguito troppo codice nei gestori eventi.

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

Evento NewInAirPackets

Interfaccia IInkCursor

Interfaccia IInkStrokeDisp