Evento InkOverlay.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]

Se a coleção desse gesto deve ser cancelada, como não apagar a tinta e disparar o evento Stroke .

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 gesto é mais rápido no modo InkAndGesture .

Para impedir a coleta de tinta enquanto estiver no modo InkAndGesture :

• Defina CollectionMode como InkAndGesture.
• Exclua o traço no evento Stroke .
• Processe o gesto no evento Gesto .

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

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

Os gestos do 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 específicos do aplicativo, consulte o tipo de enumeração InkApplicationGesture .

Requisitos

Confira também

Classe InkOverlay

Enumeração InkApplicationGesture

Método SetGestureStatus

Usando gestos