PointerPointProperties.HasUsage | hasUsage method

Gets a value that indicates whether the input data from the pointer device contains the specified Human Interface Device (HID) usage information.

Syntax

var boolean = pointerPointProperties.hasUsage(usagePage, usageId);

Parameters

usagePage

Type: Number [JavaScript] | System.UInt32 [.NET] | uint32 [C++]

The HID usage page of the pointer device.

Usage pages specify the class of device. For example, touch digitizers (0x0D) and generic input (0x01).

usageId

Type: Number [JavaScript] | System.UInt32 [.NET] | uint32 [C++]

Indicates a usage in a usage page.

Usage IDs specify a device or property in the usagePage. For example, for touch digitizers this includes tip switch (0x42) to indicate finger contact or tip pressure (0x30).

Return value

Type: Boolean [JavaScript] | System.Boolean [.NET] | Platform::Boolean [C++]

True if the input data includes usage information; otherwise false.

Remarks

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

The USB HID standard defines the configuration and communication protocols for HIDs, 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 USB HID standard, the architecture is not limited to USB devices. The input architecture also supports serial port devices, i8042 port devices, and proprietary input devices.

PointerPoint and PointerPointProperties expose common HID usages directly.

Use HasUsage to query for additional, custom, and device-specific usages or when you need to verify that a device actually supports a property (where PointerPoint and PointerPointProperties return a default value).

The following table lists the HID usages that are exposed directly through PointerPoint and PointerPointProperties.

Windows Phone 8

This API is not implemented and will throw an exception if called.

Requirements

See also

PointerPointProperties

GetUsageValue

HID Information

Build date: 2/25/2013