InkCollector.Stroke-Ereignis

Tritt auf, wenn der Benutzer einen neuen Strich auf einem beliebigen Tablet zeichnet.

Syntax

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

Parameter

Cursor [in]

Das IInkCursor-Objekt , das das Stroke-Ereignis generiert hat.

Strich [in]

Das gesammelte IInkStrokeDisp-Objekt .

Abbrechen [ein, aus]

VARIANT_TRUE , um das Ereignis abzubrechen; andernfalls VARIANT_FALSE.

Rückgabewert

Dieses Ereignis gibt keinen Wert zurück.

Bemerkungen

Diese Ereignismethode wird in den _IInkCollectorEvents-, _IInkOverlayEvents- und _IInkPictureEvents dispatch-only-Schnittstellen (dispinterfaces) mit der ID DISPID_ICEStroke definiert.

Das Strichereignis wird ausgelöst, wenn sie sich im Auswahl- oder Löschmodus befindet, nicht nur beim Einfügen von Freihand. Dies erfordert, dass Sie den Bearbeitungsmodus überwachen (den Sie festlegen müssen) und den Modus kennen, bevor Sie das Ereignis interpretieren. Der Vorteil dieser Anforderung ist eine größere Freiheit für Innovationen auf der Plattform durch ein größeres Bewusstsein für Plattformereignisse.

Hinweis

Das Stroke-Ereignis wird ausgelöst, wenn der Benutzer das Zeichnen eines Strichs abgeschlossen hat, nicht, wenn der InkStrokes-Auflistung eine Striche hinzugefügt wird. Wenn der Benutzer zum ersten Mal mit dem Zeichnen eines Strichs beginnt, wird er sofort der InkStrokes-Auflistung hinzugefügt. Das Stroke-Ereignis wird jedoch erst ausgelöst, wenn der Strich abgeschlossen ist. Daher können Striche in der InkStrokes-Auflistung vorhanden sein, die der Stroke-Ereignishandler nicht gesehen hat.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Nicht unterstützt
Header
msinkaut.h (erfordert auch Msinkaut_i.c)
Bibliothek
InkObj.dll

Siehe auch

InkCollector-Klasse

StrokesAdded-Ereignis [InkStrokes-Auflistung]

StrokesDeleted-Ereignis [InkOverlay-Klasse]

IInkCursor-Schnittstelle

IInkStrokeDisp-Schnittstelle