Compartilhar via


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:

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.

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