Enumeração InkCollectionMode (msinkaut.h)

Define valores que determinam se tinta, gestos ou tinta e gestos são reconhecidos conforme o usuário grava.

Syntax

typedef enum InkCollectionMode {
  ICM_InkOnly = 0,
  ICM_GestureOnly,
  ICM_InkAndGesture
} ;

Constantes

ICM_InkOnly Valor: 0 Coleta apenas tinta, criando um traço. O interesse do evento Gesture é definido como FALSE, o que significa que os gestos não são coletados (todos os outros interesses de evento permanecem como eram).
ICM_GestureOnly Coleta apenas gestos e não cria um traço. Gestos podem ser de um ou vários traços. Gestos de vários traços serão aceitos se os traços forem feitos dentro do tempo definido pelo temporizador interno do reconhecedor. Todos os eventos relacionados a traços e relacionados a pacotes não são disparados do InkCollector. Eventos de cursor são acionados e a tinta é sempre excluída. O interesse do evento Gesture é definido como TRUE, o que significa que os gestos são coletados (todos os outros interesses de evento permanecem como eram).
ICM_InkAndGesture Aceita apenas gestos de traço único. O evento Gesture é acionado primeiro, dando ao usuário a capacidade de dizer Cancelar = TRUE ou FALSE. O padrão é TRUE, exceto quando NoGesture é o gesto principal, Cancelar padrão para FALSE. Se TRUE, a tinta será um gesto e será excluída. Se FALSE, o gesto será tinta e um evento Stroke será acionado. O interesse do evento Gesture é definido como TRUE (todos os outros interesses do evento são mantidos como eram).

Comentários

Se um usuário tentar clicar com o botão direito do mouse e mover a caneta quando estiver no modo InkOnly ou InkAndGesture, a tinta flui da ponta da caneta. Ao manipular o evento Stroke , você deve apagar a tinta que fluiu como resultado do movimento da caneta.

Quando InkCollectionMode é definido como GestureOnly (definido por meio da propriedade CollectionMode ), o tempo limite entre quando um usuário adiciona um gesto e quando o evento Gesture ocorre é um valor fixo que não pode ser alterado programaticamente. O reconhecimento de gesto é mais rápido no modo InkAndGesture. Para impedir a coleta de tinta enquanto estiver no modo InkAndGesture, você pode:

• Defina CollectionMode como InkAndGesture.
• No evento Stroke , exclua o traço.
• No evento Gesto , processe o gesto.
• Defina DynamicRendering comoFALSE.

Ao usar essa enumeração com o controle InkPicture (ou os objetos InkCollector ou InkOverlay ) em um sistema que tenha o Microsoft Windows XP Tablet PC Edition Software Development Kit (SDK) instalado, mas que não tenha reconhecedores, o modo não pode ser definido como GestureOnly ou InkAndGesture.

O coletor de tinta sempre cria um traço (modo InkOnly) ou um gesto (modo GestureOnly) e, às vezes, cria ambos (modo InkAndGesture).

Cenários típicos para cada modo a seguir.

• InkOnly:
  1. O evento CursorInRange é acionado.
  2. Evento NewInAirPackets é acionado.
  3. O evento CursorDown é acionado.
  4. Evento NewPackets é acionado.
  5. O objeto IInkStrokeDisp é criado.
  6. Evento CursorOutOfRange é acionado.
  Nota Talvez nem sempre você queira disparar o evento CursorOutOfRange . Se você quiser continuar desenhando tinta, poderá retornar aos eventos NewInAirPackets ou CursorDown após a conclusão de um traço.
   
• GestureOnly:
  1. O evento CursorInRange é acionado.
  2. Evento NewInAirPackets é acionado.
  3. O evento CursorDown é acionado.
  4. Evento NewPackets é acionado.
  5. Um objeto IInkGesture é criado ou, se o movimento do cursor não representa um gesto, nada acontece.
  6. Evento CursorOutOfRange é acionado.
  Nota Gestos de um ou vários traços são aceitos nesse modo.
   
• InkAndGesture:
  1. O evento CursorInRange é acionado.
  2. Evento NewInAirPackets é acionado.
  3. O evento CursorDown é acionado.
  4. Evento NewPackets é acionado.
  5. Um objeto IInkGesture ou um objeto IInkStrokeDisp é criado.
  6. Evento CursorOutOfRange é acionado.
  Nota Somente gestos de traço único são aceitos nesse modo.
   

Comportamento indesejado pode ocorrer quando a propriedade CollectionMode é definida como InkAndGesture e o interesse de um objeto ou controle em um gesto conhecido é definido (chamando o método SetGestureStatus ). Se um usuário desenha tinta semelhante a um gesto que está na lista de alternativas de reconhecimento do reconhecedor, o evento Gesture é acionado e a tinta desaparece, mesmo que o gesto não seja a alternativa superior. Para evitar que a tinta desapareça e cancele a coleta do gesto, defina Cancelar como TRUE se o evento for aquele ao qual você não deseja que o reconhecedor responda.

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

Confira também

Propriedade CollectionMode [Classe InkCollector]

Evento gesto

Classe InkCollector

Classe InkOverlay

Referência de controle InkPicture

Evento Stroke