CoreInkIndependentInputSource
CoreInkIndependentInputSource
CoreInkIndependentInputSource
CoreInkIndependentInputSource
Class
Definition
Provides properties, methods, and events for handling pointer input prior to processing by an InkPresenter object.
Important
These events occur on the ink background thread. For this reason, ensure any custom processing of ink input is as lightweight as possible to avoid degraded performance and to keep your app as responsive as possible.
public : sealed class CoreInkIndependentInputSource : ICoreInkIndependentInputSourcepublic sealed class CoreInkIndependentInputSource : ICoreInkIndependentInputSourcePublic NotInheritable Class CoreInkIndependentInputSource Implements ICoreInkIndependentInputSource// This API is not available in Javascript.
- Attributes
| Device family |
Windows 10 (introduced v10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced v1)
|
Remarks
Standard Windows.UI.Input.Inking events occur after ink strokes have been rendered.
Use the Windows.UI.Input.Inking.Core pointer events to intercept raw pointer data and suppress, or cancel, ink rendering at any point along a stroke. This can be useful when protecting existing ink strokes or providing custom gesture support, such as press and hold, without creating ink artifacts.
Input from various devices (including touch, pen, and mouse) is received, processed, and managed as pointer input. User interactions from any of these devices can produce the following events. For more info, see Handle pointer input.
Properties
InkPresenter InkPresenter InkPresenter InkPresenter
Gets the InkPresenter object that manages the input, processing, and rendering of ink stroke data.
public : InkPresenter InkPresenter { get; }public InkPresenter InkPresenter { get; }Public ReadOnly Property InkPresenter As InkPresenter// This API is not available in Javascript.
Object that manages the input, processing, and rendering of ink stroke data for an InkCanvas control.
- See Also
Methods
Create(InkPresenter) Create(InkPresenter) Create(InkPresenter) Create(InkPresenter)
Retrieves a CoreInkIndependentInputSource object for handling pointer input prior to processing by an InkPresenter object.
public : static CoreInkIndependentInputSource Create(InkPresenter inkPresenter)public static CoreInkIndependentInputSource Create(InkPresenter inkPresenter)Public Static Function Create(inkPresenter As InkPresenter) As CoreInkIndependentInputSource// This API is not available in Javascript.
- inkPresenter
- InkPresenter InkPresenter InkPresenter InkPresenter
Object that manages the input, processing, and rendering of InkStroke data for an InkCanvas control.
Object that handles the pointer input for an InkPresenter object.
- See Also
Events
PointerEntering PointerEntering PointerEntering PointerEntering
Occurs as a pointer is detected entering the hit test, or bounding, area of the InkCanvas associated with the InkPresenter object.
public : event TypedEventHandler PointerEntering<CoreInkIndependentInputSource, PointerEventArgs>public event TypedEventHandler PointerEntering<CoreInkIndependentInputSource, PointerEventArgs>Public Event PointerEntering<CoreInkIndependentInputSource, PointerEventArgs>// This API is not available in Javascript.
- See Also
PointerExiting PointerExiting PointerExiting PointerExiting
Occurs as a pointer is detected leaving the hit test, or bounding, area of the InkCanvas associated with the InkPresenter object.
public : event TypedEventHandler PointerExiting<CoreInkIndependentInputSource, PointerEventArgs>public event TypedEventHandler PointerExiting<CoreInkIndependentInputSource, PointerEventArgs>Public Event PointerExiting<CoreInkIndependentInputSource, PointerEventArgs>// This API is not available in Javascript.
- See Also
PointerHovering PointerHovering PointerHovering PointerHovering
Occurs as a pointer is detected over, but not down or in contact with, the hit test, or bounding, area of the InkCanvas associated with the InkPresenter object.
public : event TypedEventHandler PointerHovering<CoreInkIndependentInputSource, PointerEventArgs>public event TypedEventHandler PointerHovering<CoreInkIndependentInputSource, PointerEventArgs>Public Event PointerHovering<CoreInkIndependentInputSource, PointerEventArgs>// This API is not available in Javascript.
- See Also
PointerLost PointerLost PointerLost PointerLost
Occurs as a pointer is no longer detected in, or over, the hit test, or bounding, area of the InkCanvas associated with the InkPresenter object.
Typically, a pointer is lost if the contact moves outside the InkCanvas control or the contact is captured by another element.
public : event TypedEventHandler PointerLost<CoreInkIndependentInputSource, PointerEventArgs>public event TypedEventHandler PointerLost<CoreInkIndependentInputSource, PointerEventArgs>Public Event PointerLost<CoreInkIndependentInputSource, PointerEventArgs>// This API is not available in Javascript.
- See Also
PointerMoving PointerMoving PointerMoving PointerMoving
Occurs as a pointer moves within the hit test, or bounding, area of the InkCanvas associated with the InkPresenter object.
public : event TypedEventHandler PointerMoving<CoreInkIndependentInputSource, PointerEventArgs>public event TypedEventHandler PointerMoving<CoreInkIndependentInputSource, PointerEventArgs>Public Event PointerMoving<CoreInkIndependentInputSource, PointerEventArgs>// This API is not available in Javascript.
- See Also
PointerPressing PointerPressing PointerPressing PointerPressing
Occurs as a pointer registers contact within the hit test, or bounding, area of the InkCanvas associated with the InkPresenter object. This can be when a mouse button is pressed or the digitizer surface is touched by a finger or pen.
public : event TypedEventHandler PointerPressing<CoreInkIndependentInputSource, PointerEventArgs>public event TypedEventHandler PointerPressing<CoreInkIndependentInputSource, PointerEventArgs>Public Event PointerPressing<CoreInkIndependentInputSource, PointerEventArgs>// This API is not available in Javascript.
- See Also
PointerReleasing PointerReleasing PointerReleasing PointerReleasing
Can occur as a pointer associated with a PointerPressing event is lifted, or released, while within the hit test, or bounding, area of the InkCanvas associated with the InkPresenter object.
PointerReleasing is not guaranteed to occur in concert with PointerPressing, as PointerLost or PointerExiting might occur instead. You should handle all events that can conclude PointerPressing.
Some reasons why PointerReleasing might not occur include:
- Differences in how specific hardware handles input
- A programmatic pointer capture from a different pointer
- User actions that change the relationship of the display area, such as changing resolution or monitor settings
- Input interactions such as a stylus touching the same surface as a previous touch action
public : event TypedEventHandler PointerReleasing<CoreInkIndependentInputSource, PointerEventArgs>public event TypedEventHandler PointerReleasing<CoreInkIndependentInputSource, PointerEventArgs>Public Event PointerReleasing<CoreInkIndependentInputSource, PointerEventArgs>// This API is not available in Javascript.
- See Also