Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

InkCollector.SetEventInterest method

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

EventId [in]

The event to be listened for.

Listen [in]

VARIANT_TRUE to indicate that the event is being used; VARIANT_FALSE if it is being ignored.

Return value

This method can return one of these values.

Return codeDescription
S_OK

Success.

E_POINTER

A parameter contained an invalid pointer.

E_INVALIDARG

Invalid event interest.

E_INK_EXCEPTION

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

Minimum supported client

Windows XP Tablet PC Edition [desktop apps only]

Minimum supported server

None supported

Header

Msinkaut.h (also requires Msinkaut_i.c)

Library

InkObj.dll

See also

InkCollector Class
CursorDown Event
CursorInRange Event
GetEventInterest Method
InkCollectorEventInterest Enumeration
NewPackets Event
Stroke Event

 

 

Community Additions

ADD
Show:
© 2015 Microsoft