mirror of
https://github.com/QB64Official/qb64.git
synced 2024-07-01 09:10:37 +00:00
47 lines
1.7 KiB
Plaintext
47 lines
1.7 KiB
Plaintext
{{DISPLAYTITLE:_LASTBUTTON}}
|
|
The [[_LASTBUTTON]] function returns the number of buttons a specified INPUT device on your computer has.
|
|
|
|
|
|
{{PageSyntax}}
|
|
: {{Parameter|buttonCount%}} = _[[_LASTBUTTON]]({{Parameter|deviceNumber}})
|
|
|
|
|
|
* Returns the number of buttons that can be read on a specified device number within the number of [[_DEVICES]] found.
|
|
* A valid number can be sent to the [[_BUTTON]] or [[_BUTTONCHANGE]] function to find any button events.
|
|
* The specific device name and functions can be found by the [[_DEVICE$]] function [[STRING|string]].
|
|
* The devices are listed in a numerical order determined by the OS and can be read by the [[DEVICE$]] function.
|
|
* '''The [[_DEVICES]] function must be read before using _LASTBUTTON or an [[ERROR Codes|"Illegal Function Call" error]] will occur.'''
|
|
* Devices include keyboard (reported as 1), mouse (reported as 2), joysticks, game pads and multiple stick game controllers.
|
|
|
|
|
|
{{PageExamples}}
|
|
''Example:'' Checking for the system's input devices.
|
|
{{CodeStart}} '' ''
|
|
devices = {{Cl|_DEVICES}} 'MUST be read in order for other 2 device functions to work!
|
|
PRINT "Number of input devices found ="; devices
|
|
FOR i = 1 TO devices
|
|
PRINT {{Cl|_DEVICE$}}(i)
|
|
PRINT "Buttons:"; {{Cl|_LASTBUTTON}}(i)
|
|
NEXT '' ''
|
|
{{CodeEnd}}
|
|
{{OutputStart}}Number of input devices found = 2
|
|
[KEYBOARD][BUTTON]
|
|
Buttons: 512
|
|
[MOUSE][BUTTON][AXIS][WHEEL]
|
|
Buttons: 3
|
|
{{OutputEnd}}
|
|
:Note: The [[STRIG]]/[[STICK]] commands won't read from the keyboard or mouse device the above example lists.
|
|
|
|
|
|
{{PageSeeAlso}}
|
|
* [[_LASTAXIS]], [[_LASTWHEEL]]
|
|
* [[_AXIS]], [[_BUTTON]], [[_WHEEL]]
|
|
* [[_DEVICES]], [[_DEVICE$]]
|
|
* [[_DEVICEINPUT]]
|
|
* [[_MOUSEBUTTON]]
|
|
* [[STRIG]], [[STICK]]
|
|
* [[ON STRIG(n)]], [[STRIG(n)]]
|
|
|
|
|
|
{{PageNavigation}}
|