PointerPointProperties.HasUsage(UInt32, UInt32) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets a value that indicates whether the input data from the pointer device contains the specified Human Interface Device (HID) usage information.
public:
virtual bool HasUsage(unsigned int usagePage, unsigned int usageId) = HasUsage;bool HasUsage(uint32_t const& usagePage, uint32_t const& usageId);public bool HasUsage(uint usagePage, uint usageId);function hasUsage(usagePage, usageId)Public Function HasUsage (usagePage As UInteger, usageId As UInteger) As BooleanParameters
- usagePage
-
UInt32
unsigned int
uint32_t
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
-
UInt32
unsigned int
uint32_t
Indicates a usage in a usage page.Usage ID 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).
Returns
bool
True if the input data includes usage information; otherwise false.
Remarks
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.
| Property | Usage page | Usage |
|---|---|---|
| Position (X) | 0x01 | 0x30 |
| Position (Y) | 0x01 | 0x31 |
| RawPosition (X) | 0x01 | 0x30 |
| RawPosition (Y) | 0x01 | 0x31 |
| IsInContact | 0x0D | 0x42 (tip) or 0x45 (eraser tip) |
| Pressure | 0x0D | 0x30 |
| IsInverted | 0x0D | 0x3C |
| IsEraser | 0x0D | 0x45 |
| Orientation | 0x0D | 0x3F |
| XTilt | 0x0D | 0x3D |
| YTilt | 0x0D | 0x3E |
| Twist | 0x0D | 0x41 |
| ContactRect (Width) | 0x0D | 0x48 |
| ContactRect (Height) | 0x0D | 0x49 |
| ContactRectRaw (Width) | 0x0D | 0x48 |
| ContactRectRaw (Height) | 0x0D | 0x49 |
| TouchConfidence | 0x0D | 0x47 |
| IsInRange | 0x0D | 0x32 |