Evento InkCollector.NewInAirPackets

Ocorre quando um pacote no ar é visto.

Sintaxe

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

Parâmetros

Cursor [in]

O objeto IInkCursor que gerou o evento NewInAirPackets .

PacketCount [in]

O número de pacotes no ar recebidos.

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

Um pacote no ar é criado quando um usuário move uma caneta perto do tablet e o cursor está dentro da janela do objeto coletor de tinta ou o usuário move um mouse dentro da janela associada do objeto coletor de tinta. Os eventos NewInAirPackets são gerados rapidamente e o manipulador de eventos 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_ICENewInAirPackets.

O evento NewInAirPackets é acionado mesmo quando está no modo de seleção ou apagamento, não apenas ao inserir tinta. Isso exige que você monitore o modo de edição (pelo qual você é responsável pela configuração) e esteja ciente do modo antes de interpretar o evento. A vantagem desse requisito é maior liberdade para inovar na plataforma por meio de maior reconhecimento de eventos de plataforma.

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

Propriedade DesiredPacketDescription

Evento NewPackets

IInkCursor Interface