IInkOverlay::SetEventInterest-Methode (msinkaut.h)

Artikel
02/29/2024

Legt einen Wert fest, der angibt, ob ein Objekt oder Steuerelement Interesse an einem angegebenen Ereignis hat.

Syntax

HRESULT SetEventInterest(
  [in] InkCollectorEventInterest EventId,
  [in] VARIANT_BOOL              Listen
);

Parameter

[in] EventId

Das Ereignis, auf das lauscht werden soll. Mögliche Werte für EventID werden im Enumerationstyp InkCollectorEventInterest angezeigt.

[in] Listen

VARIANT_TRUE , wenn das Ereignis verwendet wird, und VARIANT_FALSE , wenn es ignoriert wird.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_POINTER	Ein Parameter enthielt einen ungültigen Zeiger.
E_INVALIDARG	Ungültiges Ereignisinteresse.
E_INK_EXCEPTION	Während der Verarbeitung ist eine Ausnahme aufgetreten.

Hinweise

Alle Freihandsammlerereignisse können mit dieser Methode umgeschaltet werden. Die meisten dieser Ereignisse sind aus Leistungsgründen standardmäßig deaktiviert. Die einzigen Ereignisse, die standardmäßig aktiviert sind, sind Stroke, CursorInRange und CursorOutOfRange.

Verwenden Sie die Ereignisse NewPackets, NewInAirPackets und CursorDown sorgfältig, insbesondere weil sie sich negativ auf die Freihandleistung auswirken können, wenn in den Ereignishandlern zu viel Code ausgeführt wird.

Anforderungen

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