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:
- Adicione manipuladores de eventos para os eventos Gesto e Traço .
- No manipulador de eventos Gesture , cancele o evento Gesture para o gesto e execute a ação alternativa para o gesto.
- 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 |
|
| Biblioteca |
|