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 |
|
| Biblioteca |
|