IInkPicture::SetEventInterest-Methode (msinkaut.h)

Artikel
03/04/2024

Ä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 zu lauschende Ereignis. Mögliche Werte für eventID werden im InkCollectorEventInterest-Enumerationstyp angezeigt.

[in] Listen

VARIANT_TRUE , um anzugeben, dass das Ereignis verwendet wird; VARIANT_FALSE , um anzugeben, dass das Ereignis 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 zu viel Code in den Ereignishandlern 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