ITfHandwritingSink::DetermineProximateHandwritingTarget method (shellhandwriting.h)

Determines whether an edit control exists (or might exist in a dynamic user experience) proximate to the the pointer input.

Syntax

HRESULT DetermineProximateHandwritingTarget(
  [in] ITfDetermineProximateHandwritingTargetArgs *determineProximateHandwritingTargetArgs
);

Parameters

[in] determineProximateHandwritingTargetArgs

ITfDetermineProximateHandwritingTargetArgs interface

Return value

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Remarks

This method is called when the system has detected pen input indicating a handwriting experience might be appropriate.

Secondary clients (frameworks) are called only if a primary client (application) does not provide a response to the callback.

Secondary clients are called in reverse order of registration until either S_OK or TF_S_ASYNC response is received from the callback. An example of a secondary client could be a control that provides custom handwriting logic regardless of the application instantiating the control. Secondary clients can register by obtaining an ITfSource interface from an ITfThreadMgr instance and then calling AdviseSink with an ITfHandwritingSink interface object.

If neither primary or secondary clients allow the system to continue with the next client (or fall back to User Interface Automation (UIA)), they should return E_INVALIDARG.

If a client responds with TF_USE_SYSTEM_DEFAULT, and returns S_OK, subsequent clients will be skipped and the system will use its default UIA-based determination logic.

Requirements

Requirement	Value
Header	shellhandwriting.h