Ink input
Overview of the Ink input technology.
To develop Ink input, you need these headers:
For programming guidance for this technology, see:
Enumerations
| INK_HIGH_CONTRAST_ADJUSTMENT Specifies how the IInkD2DRenderer2 object draws ink (standard and modified) when system is in a contrast theme mode. |
| TfHandwritingFocusTargetResponse Specifies how a client that implements the IHandwritingInputRoutingCallback interface responds when the FocusHandwritingTarget function is called. |
| TfHandwritingState Specifies how handwriting is handled by the system. |
| TfInputEvaluation Specifies how the pen input should be recognized. |
| TfProximateHandwritingTargetResponse Specifies the supported handwriting behaviors based on the proximate location of a handwriting target object. |
Functions
| CreateAndInitializeInkPresenter Creates an IInkPresenterDesktop object on an application thread, connects it to the app's DirectComposition visual tree, and sets the size of the object. |
| CreateInkPresenter Creates an IInkPresenterDesktop object on an application thread. |
| DetermineProximateHandwritingTarget |
| Draw Renders the ink stroke to the designated Direct2D device context of the app. |
| Draw Renders the ink stroke to the designated Direct2D device context of the app. |
| FocusHandwritingTarget |
| GetHandwritingDistanceThreshold Retrieves the distance (vertical and horizontal) in pixels from a valid edit control for which the targetScreenPoint enables handwriting functionality. |
| GetHandwritingState Retrieves the current handwriting state for the Text Services Framework (TSF) thread manager. |
| GetHandwritingStrokeIdForPointer Retrieves the unique ID of the ink stroke associated with the specified pointer ID. |
| GetPointerTargetInfo Retrieves details about the proximate target of the pointer input. |
| GetPointerTargetInfo Retrieves details about the top-level target window of the pointer input. |
| GetSize Gets the size of the InkPresenter object. |
| GetThreadIdForInput Retrieves the ID of the message handling thread for the input target UI. |
| Invoke Executes the ink operation on an IInkDesktopHost object thread. |
| OnCommitRequested Requests that the app commit all pending Microsoft DirectComposition commands to the app's DirectComposition visual tree. |
| OnHighContrastChanged Specifies a high contrast change handler. This handler is notified of changes to the high contrast system settings. |
| QueueWorkItem Add an ink operation to a work queue for execution on the IInkDesktopHost thread. |
| RegisterHandwritingInputRoutingCallback |
| RequestHandwritingForPointer Requests that the specified pointer and ink stroke be used to provide the handwriting experience. |
| SetCommitRequestHandler Sets an IInkCommitRequestHandler object that enables the app (instead of an IInkPresenterDesktop object) to commit all pending Microsoft DirectComposition commands to the app's DirectComposition visual tree. |
| SetHandwritingState Sets the current handwriting state for the Text Services Framework (TSF) thread manager. |
| SetInputEvaluation Sets how the pen input should be recognized. |
| SetResponse Specifies the response from the callback implementation for the proximate target. |
| SetResponse Specifies the response from the callback implementation for the target. |
| SetRootVisual Sets the connection to the app's DirectComposition visual tree. |
| SetSize Sets the size of the InkPresenter object. |
Interfaces
| IHandwritingInputRoutingCallback Provides input routing support for separating the pen input handling system thread from the UI thread of the input target. |
| IInkCommitRequestHandler An IInkCommitRequestHandler object enables the app (instead of an IInkPresenterDesktop object) to commit all pending Microsoft DirectComposition commands to the app's DirectComposition visual tree. |
| IInkD2DRenderer An IInkD2DRenderer object enables the rendering of ink strokes onto the designated Direct2D device context of a Universal Windows app, instead of the default InkCanvas control. |
| IInkD2DRenderer2 An IInkD2DRenderer2 object enables the rendering of ink strokes onto the designated Direct2D device context of a Universal Windows app, instead of the default InkCanvas control. |
| IInkDesktopHost An IInkDesktopHost object enables ink input, processing, and rendering through the creation of an app thread to host an IInkPresenterDesktop object and insert it into the app's DirectComposition visual tree. |
| IInkHostWorkItem An IInkHostWorkItem object represents an ink operation to be executed on an IInkDesktopHost object thread. |
| IInkPresenterDesktop An IInkPresenterDesktop object represents an InkPresenter that can be configured and inserted into the DirectComposition visual tree of the Classic Windows app. |
| ITfDetermineProximateHandwritingTargetArgs Provides handwriting response behavior and proximate target info. |
| ITfFocusHandwritingTargetArgs Provides handwriting response behavior and target info. |
| ITfHandwriting Supports ink input with a pen on any proximate edit field without first having to set focus to the edit control. The ink strokes are rendered, handwriting recognition is performed (as either text or edit gesture), and text is entered into the edit field. |
| ITfHandwritingRequest Applications must use this interface to notify the system that they have evaluated the pen input that occurred after the handwriting request. |
| ITfHandwritingSink Supports the ability to specify custom handwriting behaviors before focus is set to an edit field. |