Evento InkCollector.NewPackets

Se produce cuando el recopilador de tinta recibe un paquete.

Sintaxis

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

Parámetros

Cursor [in]

Objeto IInkCursor que generó el evento NewInAirPackets .

Trazo [in]

Especifica el objeto IInkStrokeDisp .

PacketCount [in]

Número de paquetes recibidos para un objeto IInkStrokeDisp .

PacketData [in, out]

Cuando este método vuelve, contiene una matriz que contiene los datos seleccionados para el paquete.

Para obtener más información sobre la estructura VARIANT, vea Uso de la biblioteca COM.

Valor devuelto

Este evento no devuelve un valor.

Comentarios

Los paquetes se reciben mientras se recopila un trazo. Los eventos de paquetes se producen rápidamente y un controlador de eventos NewPackets debe ser rápido o sufrir un rendimiento.

Este método de evento se define en el _IInkCollectorEvents, _IInkOverlayEvents y _IInkPictureEvents interfaces de solo envío (dispinterfaces) con un identificador de DISPID_ICENewPackets.

Este evento se debe usar cuidadosamente, ya que podría tener un efecto adverso en el rendimiento de la entrada de lápiz si se ejecuta demasiado código en los controladores de eventos.

Para establecer las propiedades contenidas en esta matriz, utilice la propiedad DesiredPacketDescription del objeto recopilador de tintas. La matriz que devuelve el parámetro PacketData contiene los datos de esas propiedades.

Nota

Aunque puede modificar los datos del paquete, estas modificaciones no se conservan ni usan.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Encabezado	Msinkaut.h (también requiere Msinkaut_i.c)
Biblioteca	InkObj.dll

Consulte también

InkCollector (clase)

NewInAirPackets (evento)

IInkCursor (interfaz)

IInkStrokeDisp (Interfaz)