QB64-PE/internal/help/_LASTBUTTON.txt

The '''_LASTBUTTON''' function returns the number of buttons a specified number INPUT device on your computer has.


{{PageSyntax}}
::: button_count% = _LASTBUTTON(''device_number'')


* 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]].
* 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(1), mouse(2), joysticks, game pads and multiple stick game controllers.


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


''See also:''
* [[_LASTAXIS]], [[_LASTWHEEL]]
* [[_AXIS]], [[_BUTTON]], [[_WHEEL]]
* [[_DEVICES]], [[_DEVICE$]]
* [[_DEVICEINPUT]]
* [[_MOUSEBUTTON]]
* [[STRIG]], [[STICK]]
* [[ON STRIG(n)]], [[STRIG(n)]]


{{PageNavigation}}