IInkPicture::SetEventInterest method (msinkaut.h)
Modifies a value that indicates whether an object or control has interest in a specified event.
Syntax
HRESULT SetEventInterest(
[in] InkCollectorEventInterest EventId,
[in] VARIANT_BOOL Listen
);
Parameters
[in] EventId
The event to be listened for. Possible values for eventID appear in the InkCollectorEventInterest enumeration type.
[in] Listen
VARIANT_TRUE to indicate the event is being used; VARIANT_FALSE to indicate the event is being ignored.
Return value
This method can return one of these values.
| Return code | Description |
|---|---|
|
Success. |
|
A parameter contained an invalid pointer. |
|
Invalid event interest. |
|
An exception occurred during processing. |
Remarks
All ink collector events can be toggled by using this method. Most of these events are turned off by default for performance reasons. The only events that are on by default are Stroke, CursorInRange, and CursorOutOfRange.
Use the NewPackets, NewInAirPackets and CursorDown events carefully, in particular because they may have an adverse effect on ink performance if too much code is executed in the event handlers.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP Tablet PC Edition [desktop apps only] |
| Minimum supported server | None supported |
| Target Platform | Windows |
| Header | msinkaut.h |
| Library | InkObj.dll |