Compartilhar via


Evento InkCollector.Stroke

Ocorre quando o usuário desenha um novo traço em qualquer tablet.

Sintaxe

void Stroke(
  [in]      IInkCursor     *Cursor,
  [in]      IInkStrokeDisp *Stroke,
  [in, out] VARIANT_BOOL   *Cancel
);

Parâmetros

Cursor [in]

O objeto IInkCursor que gerou o evento Stroke .

Traço [in]

O objeto IInkStrokeDisp coletado.

Cancelar [entrada, saída]

VARIANT_TRUE cancelar o evento; 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_ICEStroke.

O evento Stroke é acionado quando está no modo selecionar ou apagar, não apenas ao inserir tinta. Isso exige que você monitore o modo de edição (responsável pela configuração) e esteja ciente do modo antes de interpretar o evento. A vantagem desse requisito é maior liberdade para inovar na plataforma por meio de maior reconhecimento de eventos de plataforma.

Observação

O evento Stroke é acionado quando o usuário termina de desenhar um traço, não quando um traço é adicionado à coleção InkStrokes . Quando o usuário começa a desenhar um traço pela primeira vez, ele é adicionado imediatamente à coleção InkStrokes; no entanto, o evento Stroke não é acionado até que o traço seja concluído. Portanto, os traços podem existir na coleção InkStrokes que o manipulador de eventos Stroke não viu.

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

Evento StrokesAdded [Coleção InkStrokes]

Evento StrokesDeleted [Classe InkOverlay]

IInkCursor Interface

IInkStrokeDisp Interface