Difference between revisions of "83Plus:BCALLs:4972"
From WikiTI
(→Comments) |
|||
Line 24: | Line 24: | ||
== Comments == | == Comments == | ||
− | This routine transparently handles the screen capture and remote control link commands. Other silent link commands will cause it to exit from the current app so that data can be transferred. It also handles 2nd+Off, 2nd+Up, and 2nd+Down in the expected ways. | + | This routine will wait for a key to be pressed and return it. It will handle the 2nd and Alpha keys, and the values it returns reflect this distinction. |
+ | |||
+ | This routine transparently handles the screen capture and remote control link commands, as well as (on OS 1.15 and higher) the TI-Keyboard. Other silent link commands will cause it to exit from the current app so that data can be transferred. It also handles 2nd+Off, 2nd+Up, and 2nd+Down in the expected ways. | ||
See also [[83Plus:BCALLs:500B|GetKeyRetOff]]. | See also [[83Plus:BCALLs:500B|GetKeyRetOff]]. |
Revision as of 16:43, 28 March 2005
Synopsis
Official Name: GetKey
BCALL Address: 4972h
The standard key input routine.
Inputs
- bit lwrCaseActive, (iy+appLwrCaseFlag) set to enable lowercase entry
- bit 7, (iy+28h) set to disable the usual action of 2nd+Off
- (iy+shiftFlags) contains shift settings
Outputs
- A = keycode
- (keyExtend) = extended keycode
- bit onInterrupt, (iy+onFlags) set (and A=0) if the On key was pressed
- (iy+shiftFlags) contains shift settings
Destroys
- DE, HL
Comments
This routine will wait for a key to be pressed and return it. It will handle the 2nd and Alpha keys, and the values it returns reflect this distinction.
This routine transparently handles the screen capture and remote control link commands, as well as (on OS 1.15 and higher) the TI-Keyboard. Other silent link commands will cause it to exit from the current app so that data can be transferred. It also handles 2nd+Off, 2nd+Up, and 2nd+Down in the expected ways.
See also GetKeyRetOff.
Example
B_CALL GetKey cp kPi call z,Moo