W$KEYBUF

The W$KEYBUF library routine allows to send keycodes to the runtime, simulating the user input.

Note - In order to support every existing character, the routine sends ALT+ascii-code key combinations to the input and therefore it might not work on platforms where ALT+ascii-code combinations are not supported. Also, sending keystrokes while the keyboard is in use (e.g. if keystrokes are sent when the Accept is interrupted by a key combination like CTRL+T and the two keys are still down when the routine is called) might not work.

Syntax:

CALL "W$KEYBUF" USING opCode                         parameters                 GIVING returnCode

Parameters:

opCode	Function to be executed. Valid values, defined in iscobol.def.
	WKBUF-ADD-TO-END	Add keystrokes to the end of the keyboard buffer
	WKBUF-ADD-TO-BEGINNING	Add keystrokes to the beginning of the keyboard buffer
	WKBUF-CLEAR-BUFFER	Clear the keyboard buffer
	WKBUF-START-RECORDING	Start recording keystrokes from the user input
	WKBUF-STOP-RECORDING	Stop recording keystrokes from the user input
	WKBUF-LOAD-FROM-FILE	Read keystrokes from a file and adds them to the kyboard buffer
parameter1	Parameters depend on the opcode.

Return Code:

returnCode can be any signed numeric data item. The meaning depends on the opcode.

Examples:

Example - Send some keystrokes to the standard input

move "This is an automatic text" to txt-string  inspect txt-string replacing trailing spaces by low-values  perform varying i from 1 by 1              until txt-string(i:1) = low-value          call "w$keybuf" using 2, txt-string(i:1)   end-perform.