PointerPointProperties.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

public:
bool HasUsage(
         uint32 usagePage,
         uint32 usageId
)  

Parameters

usagePage
Type: uint32 

  The Human Interface Device (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: uint32 

  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: bool 

  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 Human Interface Devices (HIDs), which is defined by the Universal Serial Bus (USB) Implementers Forum, Inc.

The Universal Serial Bus (USB) Human Interface Device (HID) standard defines the configuration and communication protocols for Human Interface Devices (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 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.

PointerPoint and PointerPointProperties expose common Human Interface Device (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 Human Interface Device (HID) usages that are exposed directly through PointerPoint and PointerPointProperties.

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

Requirements

Namespace: Windows.UI.Input

Metadata: windows.winmd

See also

Reference

PointerPointProperties Class

PointerPointProperties Members

Windows.UI.Input Namespace