Evento InkPicture.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 evento deve ser cancelado, como não apagar a tinta e disparar o evento Stroke . 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 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.
Observação
Para reconhecer gestos, você deve usar um objeto ou controle que possa coletar tinta.
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
| 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 |
|