Partilhar via


Evento InkOverlay.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 de tinta [in]

Especifica o objeto IInkStrokeDisp.

PacketCount [in]

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

PacketData [in, out]

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 deverá ser rápido ou o desempenho sofrerá.

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

Esse evento deve ser usado com cuidado, pois poderá 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 que o parâmetro PacketData retorna contém os dados dessas propriedades.

Observação

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

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows XP Tablet PC Edition [somente aplicativos de desktop]
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 InkOverlay

Evento NewInAirPackets

Interface IInkCursor

Interface IInkStrokeDisp