91 lines
2.2 KiB
Text
91 lines
2.2 KiB
Text
|
TITLE:: HIDCollection
|
||
|
|
summary:: A class describing a group of elements of an HID device
|
||
|
|
categories:: External Control>HID
|
||
|
|
related:: Classes/HID, Guides/Working_with_HID, Classes/HIDElement, Classes/HIDUsage
|
||
|
|
|
||
|
|
DESCRIPTION::
|
||
|
|
An HIDCollection defines a group of controls on a low level of the HID device, i.e. the device reports these groups. The main use to access it is to retrieve information about what kind of function the HID device performs, e.g. a GamePad, a Joystick or a Mouse.
|
||
|
|
|
||
|
|
This class is populated with information read from the device, and represents some of the internal information of the device.
|
||
|
|
|
||
|
|
CLASSMETHODS::
|
||
|
|
|
||
|
|
PRIVATE::new
|
||
|
|
|
||
|
|
|
||
|
|
INSTANCEMETHODS::
|
||
|
|
PRIVATE::printOn
|
||
|
|
|
||
|
|
METHOD:: postCollection
|
||
|
|
Post a human readable description of the collection to the post window.
|
||
|
|
|
||
|
|
|
||
|
|
METHOD:: usage
|
||
|
|
Retrieve the usage index of this collection.
|
||
|
|
|
||
|
|
returns:: a Number - the usage index of this collection
|
||
|
|
|
||
|
|
|
||
|
|
METHOD:: usagePage
|
||
|
|
Retrieve the usage page index of this collection.
|
||
|
|
|
||
|
|
returns:: a Number- the usage page index
|
||
|
|
|
||
|
|
|
||
|
|
METHOD:: usageName
|
||
|
|
Retrieve the usage name of this collection. The name is looked up from the standardized HID usage tables using the usage page index.
|
||
|
|
|
||
|
|
returns:: a String - the usage name
|
||
|
|
|
||
|
|
METHOD:: pageName
|
||
|
|
Retrieve the page name of this collection. The name is looked up from the standardized HID usage tables using the usage page index.
|
||
|
|
|
||
|
|
returns:: a String - the usage page name
|
||
|
|
|
||
|
|
|
||
|
|
METHOD:: type
|
||
|
|
The type of collection.
|
||
|
|
|
||
|
|
returns:: a number describing the type of collection.
|
||
|
|
|
||
|
|
|
||
|
|
METHOD:: device
|
||
|
|
Get the device to which this collection belongs.
|
||
|
|
NOTE:: do not set this as a user!::
|
||
|
|
|
||
|
|
returns:: an instance of HID
|
||
|
|
|
||
|
|
|
||
|
|
METHOD:: id
|
||
|
|
Index of this collection
|
||
|
|
|
||
|
|
returns:: a Number
|
||
|
|
|
||
|
|
METHOD:: parent
|
||
|
|
Index of the parent of this collection.
|
||
|
|
|
||
|
|
returns:: a Number
|
||
|
|
|
||
|
|
METHOD:: numElements
|
||
|
|
Number of elements in this collection
|
||
|
|
|
||
|
|
returns:: a Number
|
||
|
|
|
||
|
|
METHOD:: firstElement
|
||
|
|
|
||
|
|
The first element that is part of this collection.
|
||
|
|
|
||
|
|
returns:: a Number - an index indicating the first element
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
METHOD:: numCollections
|
||
|
|
Number of (child) collections in this collection
|
||
|
|
|
||
|
|
returns:: a Number
|
||
|
|
|
||
|
|
METHOD:: firstCollection
|
||
|
|
The first collection that is part of this collection.
|
||
|
|
|
||
|
|
returns:: a Number - an index indicating the first collection
|