Skip to content

Latest commit

 

History

History
44 lines (27 loc) · 7.45 KB

pointerpointproperties.md

File metadata and controls

44 lines (27 loc) · 7.45 KB
-api-id -api-type
T:Windows.UI.Input.PointerPointProperties
winrt class

Windows.UI.Input.PointerPointProperties

-description

Provides extended properties for a PointerPoint object.

In most cases, we recommend that you obtain pointer info through the pointer event handlers of your chosen Windows 8 language framework (Windows app using JavaScript, UWP app using C++, C#, or Visual Basic, or UWP app using DirectX with C++).

If the event argument doesn't expose the pointer details required by your app, you can get access to extended pointer data from the event argument through the getCurrentPoint and getIntermediatePoints methods or currentPoint and intermediatePoints properties. We recommend using the getCurrentPoint and getIntermediatePoints methods as you can specify the context of the pointer data.

The static PointerPoint methods, GetCurrentPoint and GetIntermediatePoints, always use the context of the app.

-remarks

The PointerPointProperties class implements IPointerPointProperties.

Note

This class is not agile, which means that you need to consider its threading model and marshaling behavior. For more info, see Threading and Marshaling (C++/CX) and Using Windows Runtime objects in a multithreaded environment (.NET).

The core of the Microsoft interactive input device architecture is based on the Universal Serial Bus (USB) standard Device Class Definition for Human Interface Device (HID), which is defined by the Implementers Forum, Inc.

The Universal Serial Bus (USB) Human Interface Device (HID) standard defines the configuration and communication protocols for Human Interface Device (HID), such as keyboards, mouse devices, joysticks, and virtual reality devices, that humans use to enter data directly into a computer. (For detailed information about the USB HID standard, see the USB Implementers Forum website.)

Although the core of the Windows input architecture is based on the Universal Serial Bus (USB) Human Interface Device (HID) standard, the architecture is not limited to Universal Serial Bus (USB) devices. The input architecture also supports serial port devices, i8042 port devices, and proprietary input devices.

-examples

In the following example, we query various extended pointer properties using a PointerPoint object.

[!code-csharpQueryPointer]

[!code-csharpQueryPointer]

-see-also

Windows.UI.Input Classes, Windows.UI.Input.PointerPoint.properties, Windows.Devices.Input, Windows.UI.Core, Windows.UI.Input, Windows.UI.Input.Inking, Windows.UI.Xaml.Input, TypedEventHandler, Custom user interactions, UX guidelines for custom user interactions, Touch design guidelines, User interaction mode sample, Focus visuals sample, Input: Device capabilities sample, Input: Simplified ink sample, Input: Windows 8 gestures sample, Input: XAML user input events sample, XAML scrolling, panning, and zooming sample, DirectX touch input sample, Input: Manipulations and gestures (C++) sample, Input: Touch hit testing sample, Input source identification sample, Touch injection sample, Win32 touch hit-testing sample