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 :
- Defina CollectionMode como InkAndGesture.
- Exclua o traço no evento Stroke .
- Processe o gesto no evento Gesture .
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 |
|
| Biblioteca |
|