IInkCollector::SetEventInterest-Methode (msinkaut.h)

Artikel
08/24/2023

Ändert einen Wert, 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.

[in] Listen

VARIANT_TRUE , um anzugeben, dass das Ereignis verwendet wird; VARIANT_FALSE , wenn sie 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


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