Compartilhar via


Evento InkEdit.Gesture

Ocorre quando um gesto de aplicativo é reconhecido.

Sintaxe

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

Parâmetros

Cursor [in]

O objeto IInkCursor que foi usado para criar esse gesto.

Traços [in]

A coleção InkStrokes que contém os objetos IInkStrokeDisp que compõem esse gesto.

Gestos [in]

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

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

Cancelar [entrada, saída]

Se a coleção InkStrokes que compõe esse gesto deve ser cancelada, para não apagar a tinta e disparar o evento Stroke .

Valor retornado

Se esse evento for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

Esse método de evento é definido na interface _IInkEditEvents . A interface _IInkEditEvents implementa a interface IDispatch com um identificador de DISPID_IeeGesture.

Um evento Gesture será gerado somente se o IInkStrokeDisp do objeto IInkGesture for o primeiro objeto IInkStrokeDisp desde a última chamada para o método Recognize ou o último disparo do tempo limite de reconhecimento.

Se o evento Gesture for cancelado, o evento Stroke será gerado para a coleção InkStrokes que gerou o evento Gesture .

Para que esse evento ocorra, o controle InkEdit deve assinar um conjunto de gestos de aplicativo. Para definir o interesse do controle InkEdit em um conjunto de gestos, chame o método SetGestureStatus .

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

O controle InkEdit não reconhece vários gestos de traço.

O controle InkEdit assina os gestos a seguir.

Gesto Ação
Down-left ,Down-left-long
Digite
Direita
Space
Esquerda
Backspace
Up-right, Up-right-long
Tab

Para alterar a ação padrão para um gesto:

  1. Adicione manipuladores de eventos para os eventos Gesto e Traço .
  2. No manipulador de eventos Gesture , cancele o evento Gesture para o gesto e execute a ação alternativa para o gesto.
  3. No manipulador de eventos Stroke , cancele o evento Stroke para o objeto IInkStrokeDisp que gerou o evento Gesture cancelado.

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
Inked.h (também requer inked_i.c)
Biblioteca
InkEd.dll

Confira também

Inkedit

Enumeração InkApplicationGesture

Método SetGestureStatus [Controle InkEdit]

Propriedade RecoTimeout

Evento stroke [controle InkEdit]

Usando gestos