Evento InkCollector.NewPackets

Ocorre quando o coletor de tinta recebe um pacote.

Sintaxe

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

Parâmetros

Cursor [in]

O objeto IInkCursor que gerou o evento NewInAirPackets .

Traço [in]

Especifica o objeto IInkStrokeDisp .

PacketCount [in]

O número de pacotes recebidos para um objeto IInkStrokeDisp .

PacketData [in, out]

Quando esse método retorna, contém uma matriz que contém os dados selecionados para o pacote.

Para obter mais informações sobre a estrutura VARIANT, consulte Usando a biblioteca COM.

Valor retornado

Esse evento não retorna um valor.

Comentários

Os pacotes são recebidos enquanto um traço está sendo coletado. Os eventos de pacote ocorrem rapidamente e um manipulador de eventos NewPackets deve ser rápido ou o desempenho sofre.

Esse método de evento é definido nas interfaces _IInkCollectorEvents, _IInkOverlayEvents e _IInkPictureEvents somente expedição (dispinterfaces) com uma ID de DISPID_ICENewPackets.

Esse evento deve ser usado com cuidado, pois pode ter um efeito adverso no desempenho da tinta se muito código for executado nos manipuladores de eventos.

Para definir quais propriedades estão contidas nessa matriz, use a propriedade DesiredPacketDescription do objeto coletor de tinta. A matriz retornada pelo parâmetro PacketData contém os dados dessas propriedades.

Observação

Embora você possa modificar os dados do pacote, essas modificações não são persistentes nem usadas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Cabeçalho	Msinkaut.h (também requer Msinkaut_i.c)
Biblioteca	InkObj.dll

Confira também

Classe InkCollector

Evento NewInAirPackets

IInkCursor Interface

IInkStrokeDisp Interface