Topic : The GFA-Basic Compendium Author : GFA Systemtechnik GmbH Version : GFABasic.HYP v2.98 (12/31/2023) Subject : Documentation/Programming Nodes : 899 Index Size : 28056 HCP-Version : 3 Compiled on : Atari @charset : atarist @lang : @default : Document not found @help : Help @options : +g -i -s +z @width : 75 @hostname : STRNGSRV @hostname : CAB @hostname : HIGHWIRE @hostname : THING View Ref-FileFORM_KEYBD(tree,obj,char,next_obj[,new_obj,next_char]) tree, obj, char, next_obj: iexp new_obj, next_char: ivar Allows a form to be filled out via the keyboard (see OBJC_EDIT()). Returns 0 if the Form was left by clicking on an object with EXIT or TOUCHEXIT status. Returns a value >0 if the Form should continue to be processed. tree - Address of the object tree. obj - Number of the object to be edited. char - Input character. next_obj - Number of the next EDITable object in the tree. new_obj - Returns the object to be EDITed on the next call. next_char - Returns the next character (derived form the keyboard, etc). The parameters new_obj and next_char are optional, these values can also be found by querying GINTOUT(1) to GINTOUT(2). Explanation: This routine is a subroutine of FORM_DO() and makes it possible to test a character in BASIC before it is passed to GEM, e.g. to test for Return character, which would normally cause an exit from the Form and allow it to be used to terminate an individual enrty, etc. Memo: In the original manual parameters 'char' and 'next_obj' are swapped. The function works fine. Parameter order does not match offical docs. form_keybd()+