Difference between revisions of "LASTBUTTON"

From QB64.org wiki
Jump to: navigation, search
m
(style guidelines)
 
Line 1: Line 1:
 
{{DISPLAYTITLE:_LASTBUTTON}}
 
{{DISPLAYTITLE:_LASTBUTTON}}
The '''_LASTBUTTON''' function returns the number of buttons a specified number INPUT device on your computer has.
+
The [[_LASTBUTTON]] function returns the number of buttons a specified INPUT device on your computer has.
  
  
 
{{PageSyntax}}
 
{{PageSyntax}}
::: button_count% = _LASTBUTTON(''device_number'')
+
: {{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.
 
* 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.
 
* 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 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 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!'''
+
* '''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.
+
* 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.
 
''Example:'' Checking for the system's input devices.
 
{{CodeStart}} '' ''
 
{{CodeStart}} '' ''
Line 33: Line 34:
  
  
''See also:''
+
{{PageSeeAlso}}
 
* [[_LASTAXIS]], [[_LASTWHEEL]]
 
* [[_LASTAXIS]], [[_LASTWHEEL]]
 
* [[_AXIS]], [[_BUTTON]], [[_WHEEL]]
 
* [[_AXIS]], [[_BUTTON]], [[_WHEEL]]

Latest revision as of 18:09, 6 September 2017

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


Syntax

buttonCount% = __LASTBUTTON(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.
  • 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 "Illegal Function Call" error will occur.
  • Devices include keyboard (reported as 1), mouse (reported as 2), joysticks, game pads and multiple stick game controllers.


Examples

Example: Checking for the system's input devices.

devices = _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 _DEVICE$(i) PRINT "Buttons:"; _LASTBUTTON(i) NEXT

Number of input devices found = 2 [KEYBOARD][BUTTON] Buttons: 512 [MOUSE][BUTTON][AXIS][WHEEL] Buttons: 3

Note: The STRIG/STICK commands won't read from the keyboard or mouse device the above example lists.


See also



Navigation:
Go to Keyword Reference - Alphabetical
Go to Keyword Reference - By usage
Go to Main WIKI Page