Evento InkCollector.SystemGesture

Ocorre quando um gesto do sistema é reconhecido.

Sintaxe

void SystemGesture(
  [in] IInkCursor       *Cursor,
  [in] InkSystemGesture Id,
  [in] long             X,
  [in] long             Y,
  [in] long             Modifier,
  [in] BSTR             Character,
  [in] long             CursorMode
);

Parâmetros

Cursor [in]

O objeto IInkCursor que gerou o evento SystemGesture .

Id [in]

O valor do gesto do sistema.

X [in]

A coordenada x do local do gesto.

Y [in]

A coordenada y do local do gesto.

Modificador [in]

Reservado.

Caractere [in]

Reservado.

CursorMode [in]

Um valor que indica se o objeto IInkCursor está no modo normal ou no modo borracha. 1 é para o modo normal e 2 são para o modo borracha.

Valor retornado

Esse evento não retorna um valor.

Comentários

Os gestos do sistema são úteis porque fornecem informações sobre o objeto IInkCursor que está sendo usado para criar o gesto. Eles também fornecem atalhos para combinações de eventos de mouse e são maneiras "mais baratas" de detectar eventos do mouse.

Por exemplo, em vez de procurar um par de eventos MouseUp Event / MouseDown sem outros eventos de mouse entre eles, você pode procurar os gestos do sistema Tap ou RightTap .

Como outro exemplo, em vez de escutar eventos deevento MouseMove do MouseDown / e receber várias mensagens de evento MouseMove, você pode watch para os gestos do sistema Arrastar ou RightDrag, desde que você não esteja interessado nas coordenadas (x, y) de cada posição do mouse. Isso permite que você receba apenas uma mensagem em vez de várias mensagens de Evento MouseMove .

Para obter uma lista de gestos específicos do sistema, consulte o tipo de enumeração InkSystemGesture . Para obter mais informações sobre gestos do sistema, consulte Usando gestos e entrada de comando no tablet pc.

Esse método de evento é definido nas interfaces _IInkCollectorEvents, _IInkOverlayEvents e _IInkPictureEvents somente expedição (dispinterfaces) com uma ID de DISPID_ICESystemGesture.

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
Msinkaut.h (também requer Msinkaut_i.c)
Biblioteca
InkObj.dll

Confira também

Classe InkCollector

Enumeração InkSystemGesture

IInkCursor Interface

Usando gestos

Entrada de caneta, tinta e reconhecimento

Entrada de comando no tablet pc