Compartilhar via


Evento InkCollector.Gesture

Ocorre quando um gesto específico do aplicativo é reconhecido.

Sintaxe

void Gesture(
  [in]      IInkCursor   *Cursor,
  [in]      IInkStrokes  *Strokes,
  [in]      VARIANT      Gestures,
  [in, out] VARIANT_BOOL *Cancel
);

Parâmetros

Cursor [in]

O objeto IInkCursor que gerou o evento Gesture .

Traços [in]

A coleção IInkStrokes que o reconhecedor retornou como o gesto.

Gestos [in]

Uma matriz de objetos IInkGesture , em ordem de confiança, do reconhecedor.

Para obter mais informações sobre a estrutura VARIANT, consulte Usando a biblioteca COM.

Cancelar [entrada, saída]

VARIANT_TRUE se esse gesto deve ser cancelado; caso contrário, VARIANT_FALSE.

Valor retornado

Esse evento não retorna um valor.

Comentários

Esse método de evento é definido nas interfaces _IInkCollectorEvents, _IInkOverlayEvents e _IInkPictureEvents somente expedição (dispinterfaces) com uma ID de DISPID_ICEGesture.

Quando a propriedade CollectionMode é definida como GestureOnly, o tempo limite entre quando um usuário adiciona um gesto e quando o evento Gesture ocorre é um valor fixo que você não pode alterar programaticamente. O reconhecimento de gestos é mais rápido no modo InkAndGesture .

Para impedir a coleta de tinta no modo InkAndGesture :

Para evitar o fluxo de tinta durante a geação, defina a propriedade DynamicRendering como FALSE.

Além de ao inserir tinta, o evento Gesture é acionado quando está no modo de seleção ou apagamento. Você é responsável por acompanhar o modo de edição e deve estar ciente do modo antes de interpretar o evento.

Observação

Para reconhecer gestos, você deve usar um objeto ou controle que possa coletar tinta.

Gestos de aplicativo são definidos como gestos com suporte em seu aplicativo.

Para que esse evento ocorra, o objeto ou controle deve ter interesse em um conjunto de gestos de aplicativo. Para definir os objetos ou controles de interesse em um conjunto de gestos, chame o método SetGestureStatus do objeto ou controle.

Para obter uma lista de gestos de aplicativo específicos, consulte o tipo de enumeração InkApplicationGesture .

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

Enumeração InkApplicationGesture

Método SetGestureStatus

Usando gestos